Hermes Agent

Hermes Agent 是 Nous Research 推出的终端 / 桌面 AI Agent。它支持通过 custom_providers 注册任意 OpenAI 兼容后端，适合把默认模型切换到 AsterMesh。

1. 保存 API Key

Hermes 的密钥统一放在 ~/.hermes/.env。用命令写入：

hermes config set ASTERMESH_API_KEY sk-...

也可以直接编辑 ~/.hermes/.env：

ASTERMESH_API_KEY=sk-...

2. 编辑 config.yaml

打开 ~/.hermes/config.yaml，注册 AsterMesh 并设为默认模型：

custom_providers:
  "astermesh":
    base_url: https://console.astermesh.cn/v1
    api_key_env: ASTERMESH_API_KEY

model:
  default: MODEL_ID
  provider: "astermesh"

把 MODEL_ID 换成控制台模型列表里的完整模型 ID。base_url 只填到 /v1，Hermes 会自己拼接 /chat/completions。

3. 验证配置

hermes config check   # 检查缺失项
hermes config get model

然后启动对话确认连通：

hermes chat

也可以在启动时临时指定模型，CLI 参数优先级高于 config.yaml：

hermes chat --model MODEL_ID

常见问题

• 鉴权失败：确认 ~/.hermes/.env 里存在 ASTERMESH_API_KEY，且 custom_providers 里的 api_key_env 名称与之完全一致。
• 模型不存在：model.default 必须是控制台复制的完整模型 ID，不要自己缩写。
• 仍然走了官方渠道：确认 model.provider 写的是 astermesh，而不是内置 provider 名称。

字段说明见 Hermes Agent Configuration。