🎯 一句话总结：Hermes Bot 通过 Codex 登录凭证（而非 API Key）接入 GPT-5.5 模型，实现长期稳定运行的 AI Agent 解决方案。
📌 基本信息
| 项目 | 详情 |
|---|---|
| 模型提供方 | OpenAI Codex（ChatGPT 后端） |
| 模型型号 | GPT-5.5 |
| 授权方式 | Codex 账号登录凭证（非 API Key） |
| 适用场景 | Telegram Bot / 自动化内容生成 / 交易分析助手 |
| 稳定性 | 高（支持账号池切换，防止限流） |
| 架构复杂度 | 中（需配置 Hermes + Codex CLI） |
⚙️ 接入原理与架构
传统 API 模式 vs Codex 登录模式
flowchart TD
A[用户消息] --> B(Hermes Bot)
subgraph 传统 API 模式
B --> C[OpenAI API Key] --> D[OpenAI API]
end
subgraph Codex 登录模式
B --> E[Codex 登录凭证] --> F[chatgpt.com/backend-api/codex]
F --> G[gpt-5.5]
end
核心差异：Codex 模式直接使用已登录的 ChatGPT 账号授权，无需单独的 OpenAI API Key。
推荐架构详解
graph LR
用户 -->|发送消息| Telegram
Telegram -->|Webhook| Hermes_Gateway
Hermes_Gateway --> Hermes_Agent
Hermes_Agent -->|主模型| openai-codex_Provider
openai-codex_Provider -->|切换至| Codex_账号池
Codex_账号池 -->|请求| chatgpt.com/backend-api/codex
chatgpt.com/backend-api/codex -->|返回| gpt-5.5
- 主模型固定：
openai-codex / gpt-5.5 - 备用模型：仅限 Codex 账号池内切换（如
gpt-5.2），禁止降级到其他模型（如glm-4-flash） - 配置要点：
fallback_providers必须置空，credential_pool_strategies设为fill_first
💡 优缺点分析
| 优点 | 缺点 |
|---|---|
| ✅ 无需 OpenAI API Key | ⚠️ Codex 登录态可能过期 |
| ✅ 使用账号池防止限流 | ⚠️ 账号可能被限流（需监控） |
| ✅ 适合长期运行的 AI 助手 | ⚠️ Codex 后端接口变化可能导致解析失败 |
| ✅ 支持 GPT-5.5 高级推理能力 | ⚠️ fallback 配错可能偷偷切换模型 |
🛠️ 准备工作
1. 环境要求
- 一台能运行 Hermes 的 Linux 服务器（推荐 Ubuntu 20.04+）
- 稳定的网络连接（如需代理，确保代理稳定）
- Docker 及 Docker Compose（用于部署 Hermes）
2. 工具安装
# 安装 Hermes
git clone --depth 1 https://github.com/HuoKeAI/hermes.git /root/hermes-install && \
cd /root/hermes-install && \
./install.sh
# 安装 Codex CLI（如未安装）
npm install -g codex-cli
3. 账号准备
- 主力账号：1 个已登录的 Codex / ChatGPT 账号
- 备用账号：1-2 个（用于账号池切换，防止限流）
- Telegram Bot Token：如使用 Telegram Bot 需提前创建
📋 配置步骤
步骤 1：添加 Codex 授权
# 执行授权命令
hermes auth add openai-codex
# 按提示打开登录页面
# 登录主力 Codex 账号并完成授权
# 验证授权
hermes auth list
# 应显示：openai-codex ✓
步骤 2：设置主模型
# 进入 Hermes 模型配置
hermes model
# 选择 Provider：openai-codex
# 选择 Model：gpt-5.5
# 确认切换（聊天中或 CLI 执行）
echo "/model openai-codex/gpt-5.5" | hermes cli
步骤 3：更新 config.yaml
# ~/.hermes/config.yaml
model:
default: "gpt-5.5"
provider: "openai-codex"
base_url: "https://chatgpt.com/backend-api/codex"
api_mode: "codex_responses"
max_tokens: 8192
fallback_providers: [] # 禁止任何降级模型
credential_pool_strategies:
openai-codex: "fill_first" # 账号池策略
注意：缩进必须严格保持 两个空格，
openai-codex字段不得遗漏。
🔧 验证与调试
验证命令
# 检查 Hermes 版本
hermes version
# 检查模型配置
hermes model
# 输出应为：Model: gpt-5.5；Provider: OpenAI Codex
# 模拟测试（发送测试消息）
echo "/chat 测试消息" | hermes cli
常见问题排查
| 问题 | 解决方案 |
|---|---|
| 模型切换失败（显示其他模型） | 检查 config.yaml 中 fallback_providers 是否为空 |
| 授权过期 | 重新执行 hermes auth add openai-codex |
| 响应延迟高 | 检查服务器网络，优化代理配置 |
| 账号被限流 | 添加更多 Codex 账号，配置账号池策略 |
💎 本站专属福利
👉 通过以下链接注册 RunPod 或 Together AI，即可为 Hermes Agent 提供高效 GPU 算力支持，助力长期稳定运行：
- RunPod 云 GPU 算力 （新用户赠送 $10）
- Together AI 模型托管 （高性价比模型推理）
❓ FAQ
Q：Codex 登录模式与 API Key 模式有何区别？ A：Codex 模式使用已登录的 ChatGPT 账号授权，无需单独的 OpenAI API Key，适合长期运行；API Key 模式需 OpenAI 账单支持，适合高频请求场景。
Q：如何避免账号被限流？
A：配置 credential_pool_strategies: fill_first 启用账号池切换，并准备 2-3 个 Codex 账号作为备用。同时监控 Hermes 日志，一旦发现 429 Too Many Requests 立即扩充账号池。
Q：Hermes Bot 如何切换模型？
A：通过 /model 命令或 config.yaml 配置。但注意：本教程推荐固定使用 gpt-5.5 + openai-codex，避免降级到其他模型影响稳定性。
Q：图中的架构图在哪里高清查看？ A：本文提供的架构图已转换为高清 WebP 格式，直接查看文章配图即可。
📢 进阶：多 Profile 管理
如需在多个应用中分别使用不同的 Codex 账号（如 default 和 trader Profile），按以下步骤配置：
# 添加新 Profile
hermes profile create trader
# 进入 Profile 目录
cd ~/.hermes/profiles/trader/
# 重复步骤 1-3 完成授权与模型配置
# 配置文件：config.yaml
# 授权文件：auth.json
- Agent 日志：
~/.hermes/profiles/trader/logs/agent.log - Codex CLI 授权文件：
~/.codex/auth.json（Linux） 或%USERPROFILE%\.codex\auth.json（Windows）
注意：每个 Profile 的授权文件互相独立，切换 Profile 时需重新配置模型与授权。
ＨＵＯＫＥ.ＭＥ
