Hermes Agent 凭证池：一个命令搞定多账号自动轮换

📝

凭证池让你在同一提供商下注册多个 API 密钥，一个额度用完自动切换下一个，全程零中断。4 种轮换策略，3 条命令即可上手。

核心概念

凭证池是同一提供商内的密钥轮换。比如你有三个 OpenRouter 密钥，第一个用完额度，Hermes 自动切到第二个，再用完切第三个。

与备用提供商的区别：

凭证池：同一提供商内轮换（OpenRouter A → OpenRouter B）
备用提供商：跨提供商切换（Anthropic 挂了 → 切到 OpenRouter）
优先级：凭证池先试，全部耗尽才触发备用提供商。两层防护，双保险。

三步上手

第 1 步：添加第二个密钥

# OpenRouter
hermes auth add openrouter --api-key sk-or-...-key
# Anthropic（支持 API 密钥和 OAuth）
hermes auth add anthropic --type api-key --api-key sk-ant...-key
hermes auth add anthropic --type oauth

第 2 步：查看你的池

1	hermes auth list

预期输出：

1
2
3

openrouter (2 credentials):
  #1  OPENROUTER_API_KEY   api_key env:OPENROUTER_API_KEY ←
  #2  backup-key           api_key manual

← 标记当前正在使用的密钥。

第 3 步：选择轮换策略

运行交互式命令：hermes auth → 选「Set rotation strategy」，然后挑一个：

策略	行为	适用场景
`fill_first`（默认）	一直用第一个，用完才切	密钥额度差异大
`round_robin`	每次请求轮换下一个	均匀分配，延长整体存活
`least_used`	永远选请求次数最少的	多个密钥额度接近
`random`	随机选一个健康密钥	简单粗暴

也可以直接改配置文件：

1
2
3

credential_pool_strategies:
  openrouter: round_robin
  anthropic: least_used

错误恢复机制

错误类型	处理逻辑	冷却时间
429 速率限制	先重试一次，连续第二次才轮换	1 小时
402 计费/配额	立即轮换，不重试	24 小时
401 认证过期	先刷新 OAuth，失败才轮换	—
所有密钥耗尽	触发备用提供商跨提供商切换	—

进阶功能

自定义端点池： Together.ai 或本地 Ollama 等自定义 OpenAI 兼容端点自动建独立池
子代理继承： 子代理自动继承父代理的池，无需额外配置

常见坑

添加密钥后 hermes auth list 没显示 → 密钥格式有误或提供商名拼错，用交互式向导重新添加
环境变量删除后池里还在 → 重启 Hermes 即清除
想重置冷却时间 → hermes auth reset openrouter

本文转载自微信公众号「朗朗晴空」。