文档 · 指南

让 Hermes Agent 用任意模型

Nous Research 的 Hermes Agent 用 config.yaml 里指定的模型。magpie 把自己作为一个供应商加进 Hermes，于是 Hermes 和它的每个 bot 都能用你在 magpie 里的任何模型：DeepSeek、Kimi、GLM、Qwen、OpenAI Key，或 ChatGPT、Copilot 订阅，不用往 Hermes 里贴 Key。

Hermes 的设置在 ~/.hermes/config.yaml（Windows 上是 %LOCALAPPDATA%\hermes，或 $HERMES_HOME）。magpie 在它的 providers 里加一个名为 magpie 的供应商：magpie 的网关，用 chat completions 接口，模型就是你在 magpie 里的模型。然后把 model.provider 指向它，把 model.default 设成你选的模型。你原来的供应商和模型会被记下，切回时恢复。

接入 Hermes

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Hermes Agent 那一行选模型在 Agent 页，给 Hermes Agent 一行选一个模型。
  3. 重启已打开的 Hermes 会话Hermes 只在启动时读取设置。
终端
magpie hermes deepseek/deepseek-v4-pro    # Hermes 用 DeepSeek
magpie hermes                             # 查看 Hermes 当前的模型

模型和推理强度

在 Hermes 自己的模型选择器里，magpie 的模型写作 magpie/<供应商>/<模型>。这一行还能设置推理强度，和 Hermes 的 /reasoning 是同一个设置：none、minimal、low、medium、high 或 xhigh。不设置时 Hermes 用 medium。

终端
magpie hermes effort high
magpie hermes effort default    # 恢复 Hermes 的默认

Bot 和 profile

Hermes 的每个 bot 都是一个 profile，有自己的 config.yaml。magpie 接入的是 hermes 启动时用的那个 profile：$HERMES_HOME 指定的，否则是 hermes profile use 设为常用的，否则是默认的。它也会把自己的供应商加进其他每个 profile，所以每个 bot 的选择器里都有 magpie 的模型。bot 自己设的模型保持不变。有多个 profile 时，Agent 页上其他每个 bot 都有自己的模型选择器；仍在用 magpie 上次所设模型的 bot 会跟着换到下一个，直到你单独给它选一个。

你自己的模型不受影响

在 Hermes 或 Agent 页上选一个你自己的模型，Hermes 就用它，但 magpie 的供应商会保留：Hermes 仍显示已接入，选择器里 magpie 的模型和你的模型并列。只有切回才会把这个供应商去掉。

Windows 上 WSL 里的 Hermes 也能识别：magpie 写入发行版里的 ~/.hermes，网关地址用发行版能访问到的那个。

切回

在 Hermes Agent 那一行取消 magpie，或运行 magpie hermes default。magpie 从每个 profile 里删除它的供应商，恢复你原来的供应商和模型，并让每个 bot 留在一个能启动的模型上。再次接入时，各个 bot 会回到它们原来的模型。

常见问题

Hermes Agent 能用 ChatGPT 订阅吗？

能。在 magpie 里登录 ChatGPT，在 Hermes Agent 一行选一个 GPT 模型。Hermes 把请求发给 magpie，由 magpie 使用订阅。

在 magpie 里选了模型，bot 还在用旧的？

重启这个 bot 的 Hermes 会话：Hermes 只在启动时读取 config.yaml。在 Agent 页单独选过模型的 bot 不会跟着主 profile 变。

我选了自己的模型，为什么 Hermes 还显示已接入？

magpie 的供应商会保留，让它的模型继续出现在 Hermes 的选择器里。切回即可去掉。

magpie 会动我在 Hermes 里的其他供应商吗？

不会。它只加自己的供应商，只改 model.provider、model.default，以及你设置时的推理强度。

更多 Agent 用同样的模型：让 OpenClaw 用任意模型、OpenCode 接入其他模型、让 Cline 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。