Hermes Agent

是 Hermes Agent，不是 Hermes 模型

本页讲的是 Hermes Agent —— Nous Research 的 agent 应用。它和同名的 Hermes 系列语言模型是两回事。

Hermes 把 provider 放在 ~/.hermes/config.yaml 的 custom_providers 下，再在 model 块里选用其中一个。

配置

custom_providers:
  - name: routemux
    base_url: https://api.routemux.com/v1
    key_env: ROUTEMUX_API_KEY
    api_mode: chat_completions
    default_model: openai/gpt-5.5
    models:
      openai/gpt-5.5:
        name: GPT-5.5

model:
  provider: custom:routemux
  default: openai/gpt-5.5
  base_url: https://api.routemux.com/v1

export ROUTEMUX_API_KEY="sk-..."

自定义 provider 的引用写法是 custom:<name> —— custom: 前缀是必须的。 key_env 指向一个环境变量；想把值直接写进配置就改用 api_key。

hermes model 会用交互方式走一遍同样的设置，hermes doctor 会报出它解析不了的 provider。

协议模式

api_mode 决定走哪套协议：

`api_mode`	对应的 RouteMux 端点
`chat_completions`	`/v1/chat/completions`
`codex_responses`	`/v1/responses`
`anthropic_messages`	`/v1/messages`
`bedrock_converse`	RouteMux 不提供

Claude 模型只在 anthropic_messages 上；Grok 模型完全不在它上面。全貌见兼容矩阵。

Hermes 会归一化 base URL 末尾的 /v1，所以全程用 https://api.routemux.com/v1 这一个值即可，不需要按模式换写法。

模型 id

照抄 GET /v1/models 返回的值，带上厂商前缀。models 映射的键就是这些 id，下面的 name 只是显示用的标签。

排查

现象	原因
找不到 provider	`model.provider` 漏了 `custom:` 前缀，或名字与 `custom_providers` 里的条目对不上。
key 没被读到	`key_env` 指的变量在 Hermes 实际运行的 shell 里没有导出。`hermes doctor` 会点出来。
`400 MODEL_PROTOCOL_UNSUPPORTED`	该模型不在你选的 `api_mode` 上提供。
模型被拒	id 与 `GET /v1/models` 不一致（含前缀）。
`422 BILLING_INSUFFICIENT_CREDITS`	钱包余额不足。失败请求不计费。

配置

协议模式

模型 id

排查

On this page