Hermes Agent OpenRouter 配置步骤：模型名、路由、限额和成本控制

为什么先用 OpenRouter

OpenRouter 适合第一阶段试验，因为模型选择多、切换方便，能快速比较摘要、分类、代码审查和长文档任务的成本与效果。

配置顺序

hermes model
hermes model list
hermes model set <provider/model> --provider openrouter
hermes config check
hermes doctor

配置后退出当前会话，重新打开 Hermes，再进行一次短对话。很多模型错误不是代码问题，而是当前 shell 没加载新环境变量，或者模型名和服务商列表不一致。

路由怎么设计

低风险高频任务可以优先低成本模型；代码审查、研究分析、长文档整理再切高质量模型。不要把所有任务都默认打到最贵模型。

成本记录

每个工作流都应该记录触发次数、平均输入长度、失败率和人工修改比例。一个模型便宜但经常失败，真实成本可能更高。

常见错误

401 多半是 Key 没加载；429 多半是限流或额度；model not found 多半是模型名不匹配；上下文不够则要换长上下文模型。

还没有真实场景？可以先领取 [Free Starter 模板包](/free-template-pack)，从低风险只读任务开始试跑。