指南
用 ChatGPT 订阅驱动 Hermes Agent
已经每月花 $20 订了 ChatGPT Plus?把它连到你的 Hermes Agent 实例,零额外 API 成本就能用上 GPT-5.5,不需要单独申请 API key。
用的是 OpenClaw 而不是 Hermes? 查看 OpenClaw 的 ChatGPT 订阅指南。
工作原理
Hermes Agent 支持 openai-codex provider,它把请求走你的 ChatGPT 订阅,而不是 按 token 计费的 OpenAI API。你通过设备代码(device-code)OAuth 流程登录,Hermes 用订阅 自带的额度,不产生 API 账单。
你需要什么
- 一个有效的 ChatGPT Plus($20/月)或 ChatGPT Pro($200/月)订阅
- 一个部署在 OpenClaw Launch 上的 Hermes Agent 实例
第一步:打开终端
- 进入你的 控制台,找到你的 Hermes Agent 实例。
- 点击 Terminal(终端)按钮,打开网页终端。
第二步:运行登录命令
在终端里运行:
hermes auth add openai-codex --type oauth终端会打印一个设备代码(例如 V0SZ-CL1YM)和一个网址。 在你本地电脑的浏览器里打开这个网址 —— 是你自己电脑上的浏览器,不是终端里面。
第三步:批准 OAuth 授权
- 在浏览器里访问
https://auth.openai.com/codex/device。 - 输入终端里显示的设备代码(例如
V0SZ-CL1YM)。 - 用持有 ChatGPT Plus 订阅的那个 OpenAI 账号登录并批准。
- 批准后,终端会确认:
Added openai-codex OAuth credential #1: "openai-codex-oauth-1"。 凭证保存在容器内的/opt/data/auth.json。
第四步:切换模型
从任意已连接的聊天渠道发送以下命令 —— Telegram、Discord、WhatsApp,或者控制台里的网页聊天:
/model openai-codex/gpt-5.5 --global这会在容器配置里设置 model.default = openai-codex/gpt-5.5 和 inference.provider = openai-codex。改动在下一条消息生效,无需重启。
Hermes 控制台的模型选择器目前还没把 Codex 做成一键选项,所以聊天命令是目前支持的方式。 我们会在后续更新里把它加进选择器。
第五步:验证是否生效
在你连接的平台(Telegram、Discord 或其它)给 bot 发一条消息。回复应该来自走你订阅的 GPT-5.5。你也可以查看当前模型和凭证状态:
hermes auth list可用模型
| 模型 ID | 模型 | 适合 |
|---|---|---|
openai-codex/gpt-5.5 | GPT-5.5 | 最强,全能型 |
openai-codex/gpt-5.3-codex | GPT-5.3 Codex | 代码生成、调试 |
重要提示
- 每周配额限制:ChatGPT Plus 对 Codex 访问有每周用量上限。 重度使用可能在每周重置前就触顶。
- Token 刷新:OpenAI 用的是轮转的 refresh token。 偶尔会话过期时,你可能需要重新跑一遍登录命令。
- 生产环境:如果你需要稳定的可用性、不受配额限制, 可以改用 OpenAI API key。
其他 BYOK(自带 key)方式
没有 ChatGPT Plus?你依然可以自带任意 provider 的 API key:
- OpenAI API —— 按 token 计费,无需订阅
- Anthropic Claude —— Claude Sonnet 4.6、Opus 4.6
- OpenRouter —— 一个 key 调 200+ 模型
- DeepSeek —— 低成本的代码与推理
也可以完全不用 API key —— OpenClaw Launch 开箱自带 AI 额度和免费模型。
常见问题排查
登录命令不显示设备代码
确认你跑的是 hermes auth add openai-codex --type oauth(不是 OpenClaw 的命令)。 终端必须是从控制台打开的 Hermes 网页终端。
Token 刷新报错
如果凭证失效,重新运行:
hermes auth add openai-codex --type oauth这会替换 /opt/data/auth.json 里存储的凭证。
配额超限
ChatGPT Plus 有每周上限。触顶后,bot 会一直返回错误,直到配额重置。 可以升级到 ChatGPT Pro($200/月)拿更高额度,或者换用 API key 无限使用。