第30篇：凭证池——多账号轮流用 | Easy Understand Hermes Agent

这篇讲的是 Hermes Agent 的「凭证池」功能——简单说，就是给同一个 AI 服务商准备多把钥匙，一把被限流了就自动换下一把，让你的会话不中断。

为什么要凭证池？

想象你只有一个 ChatGPT 账号，聊到一半提示“使用量已达上限”，只能干等。凭证池就像多张银行卡轮流刷：一张卡刷爆了，自动换下一张，全程无感。

它和「备用服务商」不同：凭证池是同一家换账号，备用服务商是换一家公司。Hermes 会先试凭证池，全部用完才启用备用服务商。

⚠️ 注意：换钥匙会重置提示词缓存。每次轮换，新钥匙都要按原价重新读一遍完整对话历史。长对话中每次轮换都会多花一次全价费用——这是保会话不中断的代价。

第1步：添加多个凭证

假设你已有 .env 里的 API key，Hermes 会自动识别为单钥匙池。要真正用上轮换，再加几把：

# 加第二个 OpenRouter key
hermes auth add openrouter --api-key sk-or-v1-your-second-key

# 加第二个 Anthropic key
hermes auth add anthropic --type api-key --api-key sk-ant-api03-your-second-key

# 用 OAuth 登录（需要 Claude Max 套餐）
hermes auth add anthropic --type oauth

查看当前池子：

hermes auth list

输出中 ← 标记当前选中的凭证。

第2步：选择轮换策略

在 config.yaml 里配置：

credential_pool_strategies:
  openrouter: round_robin
  anthropic: least_used

策略	行为
`fill_first`（默认）	第一把用到废，再换下一把
`round_robin`	轮流用，每把都用
`least_used`	总选用得最少的
`random`	随机挑健康的

第3步：了解错误处理逻辑

错误	处理方式	冷却时间
429 限流	同钥匙重试一次，再失败就换	1小时
402 欠费	立即换下一把	1小时
401 过期	先尝试刷新 OAuth，失败才换	5分钟
全部耗尽	启用备用服务商	—

第4步：管理池子

运行 hermes auth 打开交互菜单，可以添加/删除凭证、重置冷却、改策略。

删除凭证用索引号：

hermes auth remove anthropic 2

小技巧

子代理自动共享池子：delegate_task 派生的子代理直接用父代理的凭证池，不用额外配置。
自定义端点也有池：比如 Together.ai 或本地服务器，用端点名作为池子标识。
自动发现：环境变量、Claude Code 凭证、OAuth 状态都会自动进池，删掉环境变量对应条目也会自动移除。

总结

凭证池就是给 AI 服务商多备几把钥匙，限流自动换。核心操作三步：hermes auth add 加钥匙 → 选策略 → 放心用。记住：换钥匙会重置缓存，长对话每次轮换多花一次全价费用。