← Hermes Agent 中文介绍

指南

用 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/月)+ OpenClaw Launch Lite($3/月) = GPT-5.5,每月共 $23。没有按 token 的 API 费用。

你需要什么

  • 一个有效的 ChatGPT Plus($20/月)或 ChatGPT Pro($200/月)订阅
  • 一个部署在 OpenClaw Launch 上的 Hermes Agent 实例

第一步:打开终端

  1. 进入你的 控制台,找到你的 Hermes Agent 实例。
  2. 点击 Terminal(终端)按钮,打开网页终端。

第二步:运行登录命令

在终端里运行:

hermes auth add openai-codex --type oauth

终端会打印一个设备代码(例如 V0SZ-CL1YM)和一个网址。 在你本地电脑的浏览器里打开这个网址 —— 是你自己电脑上的浏览器,不是终端里面。

第三步:批准 OAuth 授权

  1. 在浏览器里访问 https://auth.openai.com/codex/device
  2. 输入终端里显示的设备代码(例如 V0SZ-CL1YM)。
  3. 用持有 ChatGPT Plus 订阅的那个 OpenAI 账号登录并批准。
  4. 批准后,终端会确认: 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.5GPT-5.5最强,全能型
openai-codex/gpt-5.3-codexGPT-5.3 Codex代码生成、调试

重要提示

  • 每周配额限制:ChatGPT Plus 对 Codex 访问有每周用量上限。 重度使用可能在每周重置前就触顶。
  • Token 刷新:OpenAI 用的是轮转的 refresh token。 偶尔会话过期时,你可能需要重新跑一遍登录命令。
  • 生产环境:如果你需要稳定的可用性、不受配额限制, 可以改用 OpenAI API key

其他 BYOK(自带 key)方式

没有 ChatGPT Plus?你依然可以自带任意 provider 的 API key:

也可以完全不用 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 无限使用。

用你的 ChatGPT 订阅部署 Hermes

在 Telegram 或 Discord 上拥有一个 GPT-5.5 的 Hermes Agent —— 由你已有的订阅驱动。

部署 Hermes