客户端接入/Hermes Agent
在 Hermes Agent 中使用 Wokey API
准备好 Wokey API Key，把 Hermes Agent 的 Base URL 指向 Wokey，再用一条 curl 请求确认连通。
更新于
准备 API Key 与 Base URLlink
所有客户端都用同一个 Wokey API Key 和同一个 Base URL。
使用 Wokey Base URL
客户端的 Base URL 填网关域名，按下方配置决定是否追加 /v1。
配置客户端link
Hermes Agent 只需要在配置文件前五行指定模型、custom provider、Base URL 和 API Key。使用 GPT 模型（如 gpt-6-sol）时，额外加一行 api_mode: codex_responses 可获得最佳缓存命中率；其它模型（如 Claude）保持默认即可。
# ~/.hermes/config.yaml
model:
default: claude-opus-5-5
provider: custom
base_url: https://api.wokey.ai
api_key: YOUR_API_KEY
# 仅 GPT 模型（如 gpt-6-sol）：取消注释以获得最佳缓存命中率
# api_mode: codex_responses协议与 Base URL 写法link
同一个客户端换协议时，Base URL 带不带 /v1 可能不同。
| 协议 | Base URL 写法 | 建议用于 |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek、GLM、Kimi 等其他模型 |
配置位置: ~/.hermes/config.yaml
用 Opus 5.5 把 Hermes Agent 跑成常驻代理：和 Claude Duet 的区别link
Anthropic 在 2026-10-21 推出了 Claude Duet 研究预览：由 Claude Opus 5.5 驱动的主动型代理，每天早上发简报，后台盯着已连接的应用，动手前先问你。Duet 只能登录 Claude 账号使用，没有 API Key 或自定义 Base URL 的入口，Wokey 无法接入。Hermes Agent 是开源、自托管的常驻代理，接上 Wokey 后可以用同一个 Opus 5.5 模型，不用排候补名单，也不限地区。
| Claude Duet | Hermes Agent + Wokey | |
|---|---|---|
| 模型 | Claude Opus 5.5，不能更换 | claude-opus-5-5，也可以换成 Wokey 上的其他模型 |
| 谁能用 | 美国的 Claude Pro / Max 订阅用户，需排候补名单；Team、Enterprise 暂不支持 | 自行安装，有 Wokey API Key 即可，不限地区 |
| 费用 | 预览期不另收费，但与聊天、Claude Code 共用订阅额度，后台检查也计入额度 | 按 token 计费，从 Wokey 余额扣除；检查频率由你决定 |
| 在哪里运行 | Anthropic 云端虚拟机，自带浏览器，手机和电脑关机后仍可工作 | 你自己的电脑或服务器；要全天在线就部署在常开的机器上 |
| 怎么和它对话 | Duet App（iOS / Android）和 claude.ai | 接入 Telegram、Slack 等聊天应用 |
| 记忆与工具 | 继承 Claude 账号的记忆、skills 和连接器 | 记忆、skills 和工具都在本地，自己安装和管理 |
| 动手前确认 | 发消息、付款、签署、删除前必须你确认；证券交易和账户间转账一律禁止 | 权限和确认规则由你配置，建议只授权必要的账号 |
- 按 token 计费时，检查越频繁越贵：每次检查都会重新发送系统提示和记忆。例行巡检可以用更便宜的模型（如 claude-sonnet-5-5、deepseek-v4.1-flash），需要判断和动手时再用 Opus 5.5。
- Opus 5.5 经 Chat Completions 调用时会先思考再输出，首字比较慢；后台运行的常驻代理一般不受影响。
- 上方配置默认就是 claude-opus-5-5，不需要改动。
Duet 信息核对日期 2026-10-22 · Duet 信息来源：Introducing Claude Duet · Claude Duet FAQ
用 curl 验证link
客户端报错时，先用 curl 排除 Key 和 Base URL 的问题。
Hermes Agent 默认使用 OpenAI Chat Completions 协议。这条请求返回 200，说明 Key 和 Base URL 都正确；发送前把 YOUR_API_KEY 换成你的 Key。
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'错误与排障link
先区分认证、额度、限流、模型不可用和上游超时。
invalid api key
Key 缺失、写错、已删除，或 Authorization / x-api-key 认证 Header 冲突。
insufficient balance
账户额度不足，需要充值后继续请求。
model_denylisted / account_restricted
该模型或整个账号因反复违规被暂停调用，处理方法见「违规处置费与风控限制」。
request_blocked
这个请求被拦截，没有发往上游，也不收费。例如原样重发刚被模型拒绝的请求，或某个终端用户（X-End-User-Id）被暂停。报错信息会说明拦截的范围；按提示修改请求或稍后再试，其他请求不受影响。
rate limited
请求过于频繁，稍后重试或降低并发。如果只有某一个模型或某一个终端用户（X-End-User-Id）持续返回 429，可能是违规后的临时限流。
client disconnected
客户端在响应完成前断开了连接（code 为 downstream_aborted），默认不收费。账号过去 24 小时的客户端断开达到 50 次、并且占全部请求的 10% 以上时，之后断开的请求会自动按上游报告的用量计费：已处理的输入（含缓存读写）照收，输出只在上游给出计数时才收；上游还没报告用量就断开的，仍然免费。开始计费时会通知账号；断开比例回到正常范围后，计费在一小时内自动停止。常见原因是客户端或代理的超时设得太短，或者程序在请求完成前主动取消了它。
upstream unavailable
上游模型服务暂不可用，通常可以切换模型或稍后重试。
upstream timeout
上游响应超时，建议缩短上下文、降低 max_tokens 或重试。
upstream overloaded
上游模型暂时过载，Wokey 已先换线路重试过（code 为 upstream_overloaded），和你的余额无关。稍后重试或切换模型。
常见问题link
- Hermes Agent 的 base_url 要不要加 /v1？
- 不加，base_url 填 https://api.wokey.ai，provider 填 custom。
- api_mode: codex_responses 什么时候加？
- 只在使用 GPT 模型（例如 gpt-6-sol）时加这一行，缓存命中率最好。Claude 等其他模型保持默认，不要加。
- API Key 写在哪里？
- 写在 ~/.hermes/config.yaml 里 model 下的 api_key 字段，只填 Key 本身。