Hermes Agent OpenRouter 报 model not found 怎么排查

先确认报错发生在哪里

`model not found` 可能发生在模型列表、会话启动、工作流执行或 Gateway 调用。不要只看最后一行错误，要确认是哪一步传错了模型名。

第一组检查

hermes model
hermes model list
hermes config check
hermes doctor

如果 CLI 里模型能用，但 Gateway 里不能用，问题通常不在模型本身，而在 Gateway 进程没有加载最新环境变量。

常见原因

• 模型名写错，少了 provider 前缀或拼写不一致。
• API Key 没加载到当前 shell。
• 配置改了但没有重启 Hermes 会话或后台进程。
• 当前模型被服务商下架、限流或区域不可用。
• 选择了上下文太小或不支持工具调用的模型。

推荐修复顺序

先换一个明确可用的模型跑短对话；再恢复你的目标模型；最后检查路由和限额。不要同时改模型名、API Key、Gateway 和 Prompt，否则无法判断到底是哪一步修好的。

记录下来

修好以后，把可用模型名、配置位置、重启方式和当天时间写进项目 README 或 Memory。下次出问题时，你能快速判断是配置变了，还是模型供应商变了。

下一步

如果你还没有真实场景，可以先领取 Free Starter 模板包，从每日简报、Issue 分类和内容选题三个低风险任务开始。