配置 Hermes Agent

Hermes Agent 是 Nous Research 开发的开源 AI agent 框架，与 Claude Code、Codex、OpenClaw 同属一类——可在终端、消息平台和 IDE 中使用工具调用完成复杂任务。

Kitcoding 支持通过 Anthropic 兼容端点接入 Hermes。

前置条件

已 创建 API 令牌，推荐分组：根据所用模型选择对应分组。

• 使用 Claude 模型 → Claude特价-缓存优化 或 VIP
• 使用其他模型 → 按 模型广场 选择对应分组

一、安装

macOS / Linux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows (PowerShell)

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装说明

Hermes 使用 Python（uv 管理依赖），原生安装脚本会自动处理 Python 3.11、Node.js、ripgrep、ffmpeg 等全部依赖。Windows 下还会自动安装便携 Git Bash，无需额外配置。

验证安装

hermes --version 可检查安装状态。首次运行 hermes 会自动生成 ~/.hermes/ 配置目录。

二、配置要点

1. provider 填写协议适配器名，而非中转商名。 应填 anthropic，不是 kitcoding 或 custom。中转由 base_url 指定。

2. model 填写官方模型 ID，而非中转商别名。 例如 claude-sonnet-4-6。使用自定义别名会导致 404 或空响应。

3. provider 决定 API 格式与默认端点。 调用 Claude 必须使用 provider: anthropic。填写错误（如 gemini 或 custom）会绕过 base_url，将请求发往错误的服务端。

三、推荐配置

配置文件：~/.hermes/config.yaml

model:
  default: claude-sonnet-4-6         # 必须是 Anthropic 官方模型 ID
  provider: anthropic                # 协议适配器名，不是 "kitcoding" 或 "custom"
  base_url: https://kitcoding.com    # 中转入口（Anthropic 格式不加 /v1）
  api_key: "sk-..."                  # Kitcoding 签发的令牌

# 重要：关闭模型目录，防止覆盖手填的模型名
model_catalog:
  enabled: false

如果不想把 API Key 明文写在 config.yaml 里，可用环境变量引用：

model:
  api_key: ${KITCODING_API_KEY}

然后在 ~/.hermes/.env 中添加：

KITCODING_API_KEY=你的-kitcoding-令牌

配置文件路径

Hermes 默认读取 ~/.hermes/config.yaml。如果用 hermes --profile <name> 多 profile 管理，配置文件在 ~/.hermes/profiles/<name>/config.yaml。

四、验证

改完配置后重启 gateway：

hermes gateway restart

然后验证：

hermes doctor                     # 诊断 provider/鉴权
echo "say hello" | hermes run -   # CLI 冒烟测试

能正常返回即配置成功。

五、常见错误速查

错误现象	原因	修复
Unknown provider 'kitcoding'	provider 填了中转商名	改为 anthropic
消息无回复、不报错	provider: custom 走了 OpenAI 格式，模型名无效导致空响应	改为 anthropic + 官方模型 ID
HTTP 404	provider: gemini 强制走 Google 端点，绕开了 base_url	改为 anthropic
模型名不生效	model_catalog.enabled: true 覆盖了手填值	设为 false

六、Hermes vs 其他工具

	Claude Code	Codex	Hermes Agent
开发商	Anthropic	OpenAI	Nous Research
开源	否	否	是
默认模型	Claude	GPT	可选任意
多 provider	单一	单一	内置支持
消息平台	否	否	Telegram/Discord 等

Hermes 的主要优势是开源 + 多 provider 原生支持 + 消息平台接入。

七、使用 delegate_task（子 agent）的注意事项

如果使用 Hermes 的 delegate_task 功能派出子 agent，需要注意凭证路由问题——默认配置下子 agent 可能被错误路由到 Anthropic 官方端点导致 401。详见 Hermes delegate_task 修复。

---

致谢

本文核心结论来自社区用户 Vincent Lau 的完整排查与实测验证（2026-06-08 ~ 06-10）。感谢细致的排查与分享。

经验补充

用 Hermes 配 Kitcoding 的实战经验欢迎 投稿。