Hermes Agent API 接入:配置与常见问题

Hermes Agent 是 Nous Research 开源的通用 Agent,可以在终端里运行,也能接入聊天软件。它支持自定义的 OpenAI 兼容端点,把地址指向 FlyRouter 即可。

更新日期:

用向导配置

运行模型向导

终端
hermes model

选择自定义端点

在列表里选择 Custom endpoint (self-hosted / VLLM / etc.),按提示依次填写:

提示填写内容
API base URLhttps://api.flyrouter.ai/v1
API key你的 FlyRouter Key(sk-...)
Model name模型 ID,例如 claude-sonnet-5-5

API 模式选择 chat_completions。上下文长度可以留空。

直接编辑配置文件

向导写入的是 ~/.hermes/config.yaml,也可以手动编辑。把 Key 放在 ~/.hermes/.env,配置里只引用变量名:

~/.hermes/config.yaml
providers:
  flyrouter:
    api: https://api.flyrouter.ai/v1
    key_env: FLYROUTER_API_KEY
    transport: chat_completions
model:
  default: claude-sonnet-5-5
  provider: custom:flyrouter
~/.hermes/.env
FLYROUTER_API_KEY=sk-...

切换模型

在会话里用 /model 切换,格式是 custom:供应商名:模型 ID:

text
/model custom:flyrouter:gpt-6.1-sol

/model 只能在已经配置好的供应商之间切换;新增供应商要用 hermes model。

常见问题

  • 401:~/.hermes/.env 里的变量名要和 key_env 一致。Hermes 不会把 OPENAI_API_KEY 用在自定义端点上。
  • 404:api 需要带 /v1。
  • 找不到模型:模型 ID 要与 模型价格 页面列出的一致。