先分清 401 和 429
`401` 通常是身份问题，优先看 API Key 和 Provider 配置。`429` 通常是额度或限流问题，优先看调用频率、模型限制和账户额度。两个错误的修复方向不同，不要混在一起处理。
401：先查 Key 是否被当前会话读到
hermes model
hermes config check
hermes doctor
printenv | grep -i openrouter如果你刚改完环境变量，退出当前 Hermes 会话，重新打开终端再试。很多 401 不是 Key 错，而是后台进程仍然拿着旧环境变量。
429：先降频，再缩短输入
# 先用一句短问答确认链路
hermes不要一上来跑长报告、批量摘要或多轮工具调用。先用短输入确认模型能返回，再逐步恢复工作流。定时任务要检查触发频率和失败重试，避免错误重试把限流放大。
记录可用模型和当天状态
把可用模型名、Key 存放位置、错误时间、触发任务和修复方式写进项目 README。下次出现 401 或 429 时，先对比配置是否变过，再判断是否是平台额度变化。
推荐恢复顺序
- 短问答验证 Provider。
- 确认 Key 和当前 shell。
- 确认模型名和账户额度。
- 降低工作流触发频率。
- 最后再调整 Prompt、routing 和备用模型。
下一步
如果你还没有真实场景，可以先领取 Free Starter 模板包，从每日简报、Issue 分类和内容选题三个低风险任务开始。
常见问题
把搜索里最常见的疑问集中放在这里，适合排查时快速确认方向。
OpenRouter 401 一般是什么原因？+
优先检查 API Key 是否复制完整、是否加载到当前 shell、配置后是否重启了 Hermes 会话，以及当前 Provider 是否真的指向 OpenRouter。
OpenRouter 429 一般怎么处理？+
429 多半是额度、限速或短时间触发太频繁。先降低任务频率，换短输入测试，再看模型平台额度和当前模型限制。
要不要一报错就换模型？+
不要一开始同时换模型、Key、Prompt 和工作流。先用一个短问答复现，再逐项排查。