OpenRouter 401 排查 应该从哪里开始？
建议先打开「打开 401 / 429 排查」，按本页的步骤完成最小验证，再阅读相关排错和视频内容。
Topic guide
OpenRouter 401 专题怎么读
401 优先看 API Key、环境变量、Provider 和会话重启。
- 01确认 Key 是否完整
- 02确认当前 shell 和后台进程都能读取
- 03短问答验证 Provider
这个专题适合谁
OpenRouter 401 排查 适合已经能启动 Hermes Agent，但卡在模型、API Key、限流、模型名或成本控制的人。先让一个模型稳定，再谈复杂 routing。
读完后的验收标准
一个低风险工作流连续运行 3 次，模型返回稳定，失败原因和成本都能记录。
先检查这三件事
01用短问答验证 Provider 和模型名，不要一开始跑长工作流
02区分 401、429、model not found 和上下文不足
03记录触发次数、失败率、重试次数和人工修改比例
常见误区
一上来配置复杂路由，导致排错面扩大
只看模型单价，不看失败重试和人工修改成本
改了环境变量却没有重启当前会话或后台进程
常见问题
401 相关问题怎么判断是否已经解决？
一个低风险工作流连续运行 3 次，模型返回稳定，失败原因和成本都能记录。
读完 OpenRouter 401 排查 后下一步做什么？
如果还没有真实场景，先下载免费 Starter 包，选择日报、Issue 分类或内容选题这类只读模板跑一次。
读完专题，建议做一次验证
只看教程不够。下载 Starter 包，选一个日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
⌘ api
模型接入·更新 2026-05-19·8 分钟阅读
Hermes Agent OpenRouter 401 和 429 报错：API Key、额度和限流排查
OpenRouter 返回 401、invalid key、429、rate limit 或 timeout 时，按 API Key、环境变量、额度、模型和触发频率定位。