Hermes Agent API 接入:配置与常见问题
Hermes Agent 是 Nous Research 开源的通用 Agent,可以在终端里运行,也能接入聊天软件。它支持自定义的 OpenAI 兼容端点,把地址指向 FlyRouter 即可。
更新日期:
用向导配置
运行模型向导
终端
hermes model选择自定义端点
在列表里选择 Custom endpoint (self-hosted / VLLM / etc.),按提示依次填写:
| 提示 | 填写内容 |
|---|---|
| API base URL | https://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 要与 模型价格 页面列出的一致。