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

为什么先用 OpenRouter

OpenRouter 适合第一阶段试验，因为模型选择多、切换方便，能快速比较摘要、分类、代码审查和长文档任务的成本与效果。前提是你能稳定访问 openrouter.ai；国内网络直连不稳定的话，先看 国内安装与使用指南 里不用梯子的 Provider，配置思路和下面完全一样。

配置顺序

hermes model                                   # 在选择器里选 OpenRouter，按提示填 Key 和模型
hermes config set OPENROUTER_API_KEY <你的 Key>  # 不走向导时直接写 Key
hermes config set model.provider openrouter
hermes config set model.default <模型 ID>
hermes doctor

用选择器配好就不需要后面三条 config set；它们适合脚本化或只改一项的情况。Key 会写进 ~/.hermes/.env，Hermes 以这个文件为准，它会覆盖 shell 里 export 的同名变量。配置后退出当前会话，重新打开 Hermes，再进行一次短对话。很多模型错误不是代码问题，而是 .env 里的 Key 没更新，或者模型名和服务商列表不一致。

配置后先跑通，再优化

第一轮不要急着调 provider routing、fallback、排序和复杂模型策略。先让一个模型稳定完成短问答，再跑 Starter 包里的一个只读模板。链路稳定后，再把任务拆成高频低成本和低频高质量两类。一次只改一个变量：模型、Prompt、Provider 和工作流同时改，出了问题没法判断是哪一步。

按任务分层选模型和路由

• 信息摘要、日报、RSS 整理：优先低成本模型，重点是稳定和便宜。
• 分类打标：看一致性，不只看价格。
• 代码审查、需求拆解、研究综述：选择推理能力更好的模型。
• 对外回复、客户跟进：需要更严格的质量控制和人工确认。

不要把所有任务都打到同一个模型，也不要为了省一点单价牺牲大量人工修改时间。低风险任务先自动化，高风险任务先出草稿，再人工确认。路由只在单模型链路稳定之后再加：低风险高频任务走低成本模型，代码审查、研究分析、长文档整理再切高质量模型。sort、only、ignore、order 这些参数的具体写法见 OpenRouter Provider Routing 配置。

成本记录

每个工作流都应该记录触发次数、平均输入长度、平均输出长度、失败率和人工修改比例。一个模型便宜但经常失败，真实成本可能更高。跑 1-2 周后再决定是否升级模型，而不是凭感觉调参。

date,workflow,model,input_size,status,retry_count,human_edit_minutes
2026-05-31,daily-brief,openrouter/model,medium,success,0,3

常见错误怎么排

401 多半是 ~/.hermes/.env 里的 Key 写错或已失效；429 多半是限流或额度；model not found 多半是模型名不匹配；上下文不够则要换长上下文模型；CLI 能用但 Gateway 不能用，优先重启 Gateway。一次只改一个变量，才能判断到底是哪一步恢复。具体步骤见 OpenRouter 401 和 429 报错排查 和 OpenRouter model not found 排查，Provider 的整体选法见 模型接入指南。

注意事项

不要把 API Key 写进前端代码。所有敏感 Key 都应只存在于服务端环境变量或 ~/.hermes/.env 中。截图、录屏、日志和网盘资源包里也不要出现真实 Key。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。