OpenRouter Provider Routing：怎么让 Hermes Agent 兼顾成本、速度和质量

什么时候需要 Provider Routing

刚开始使用 Hermes Agent 时，不建议一上来就调复杂路由。先让一个模型稳定工作，再考虑成本、速度和质量。如果你的日报、摘要、分类任务已经跑了 1-2 周，并且开始关心月成本，就可以看 OpenRouter 的 provider_routing。

常见配置思路

• 低成本任务：优先 `sort: "price"`，适合摘要、分类、格式整理。
• 高质量任务：使用 `order` 指定更信任的供应商顺序。
• 合规或隐私要求：用 `only` 或 `ignore` 控制可用供应商。
• 参数兼容：需要严格工具调用或特定参数时，考虑 `require_parameters`。

示例配置

provider_routing:
  sort: "price"
  only: []
  ignore: []
  order: []
  require_parameters: false
  data_collection: null

不要只看单次价格

真正的成本是“失败重试 + 人工修改 + 运行频率”的总和。便宜模型如果分类不稳定，可能会让后续人工成本更高。建议每个工作流记录触发次数、失败次数、人工修改比例和月度模型费用。

OpenRouter 之外：proxy、auth、portal 各管一层

provider_routing 解决的只是"OpenRouter 内部挑哪家供应商"。Hermes 自身还有三个路由相关的命令，各自负责不同层面，分清楚再动手。

`hermes proxy` 在本地起一个 OpenAI 兼容代理，专门对接 OAuth 类 provider：只认 OpenAI 接口的旧脚本和第三方工具，把端点指向这个本地代理，就能借用你在 Hermes 里配好的认证，不必给每个工具单独发一份 Key。它还顺手解决了"策略只配一处"的问题——外围工具全都打这同一个本地端点，路由调整不用逐个工具去同步。

`hermes auth` 负责池化凭证，与 `hermes login`、`hermes logout` 配套：登录登出走 login 和 logout，多份凭证的集中管理走 auth。手里不止一份订阅或不止一个账号时，统一收进池里，省掉在配置文件里来回手工切换。

`hermes portal` 面向 Nous Portal，查看状态与订阅，并承担 Tool Gateway 这一层的路由。订阅在 Portal 上的用户，工具调用走的网关也归它管，工具相关的路由异常先到这里看状态再说。

分工可以一句话记住：provider_routing 挑供应商，proxy 转接口形态，auth 管凭证，portal 管 Portal 侧的工具网关。出问题先想清楚坏在哪一层，再去对应命令下排查，别在 OpenRouter 控制台里找 Hermes 本地代理的毛病。

直连 provider 是第二个成本档位

在 sort 和 order 里反复微调，收益有上限。Hermes 可直连的 provider 还包括 NovitaAI、NVIDIA NIM（Nemotron）、Xiaomi MiMo、z.ai/GLM、Kimi/Moonshot、MiniMax、Hugging Face、OpenAI 以及任何自有端点，切换模型不需要改代码。实际做法：挑一个高频低价值的工作流，从 OpenRouter 挪到某家直连 provider 单独跑一周，两个档位各自的账单和失败情况分开看，再决定长期落点。对比窗口内冻结 provider_routing 的参数别动，两头同时变就没法归因了。换档位带来的降本空间，通常大于在同一档位里继续调参；先定问题出在哪一层，再去拧那一层的旋钮，五个入口一起拧只会把账算糊。

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