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