跳到主要内容

使用 Hermes Agent

Hermes Agent 支持自定义推理端点。你可以通过配置向导，或手动编辑配置文件，将它接入 ClawdRouter 的 OpenAI 兼容 API。

准备工作​

  • 已安装 Hermes Agent。
  • API Key。
  • 当前 API Key 有权限调用的模型 ID。

请勿将真实 API Key 写入仓库、公开文档或截图。

1. 安装 Hermes Agent​

macOS、Linux 或 WSL​

在终端中执行官方安装命令：

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

安装完成后重新加载终端配置，并验证版本：

source ~/.bashrc
hermes --version

如果提示找不到 hermes，关闭并重新打开终端后再次执行 hermes --version。

Hermes Agent 不通过 npm 安装，因此不依赖当前使用的 Node.js 版本。

2. 通过向导配置（推荐）​

运行：

hermes model

选择 Custom endpoint，然后按下表填写：

字段填写内容
API Base URL__DOCS_API_ORIGIN__/v1
API Key真实 API Key
Model nameYOUR_MODEL_ID
API modechat_completions

向导会将配置保存到 ~/.hermes/config.yaml。密钥应保存在 ~/.hermes/.env 中。

截图位置 2：插入 Custom endpoint 填写完成的截图，真实 API Key 必须遮挡。

3. 手动配置（可选）​

创建配置目录：

mkdir -p ~/.hermes

编辑 ~/.hermes/.env，写入以下内容，并将 YOUR_API_KEY 替换为真实 API Key：

CLAWDROUTER_API_KEY=YOUR_API_KEY

编辑 ~/.hermes/config.yaml：

custom_providers:
  - name: clawdrouter
    base_url: __DOCS_API_ORIGIN__/v1
    key_env: CLAWDROUTER_API_KEY
    api_mode: chat_completions

model:
  provider: custom:clawdrouter
  default: YOUR_MODEL_ID

保存后执行：

hermes config check

4. 在项目中启动 Hermes Agent​

进入代码项目目录：

cd /path/to/your/project
hermes

启动后，可输入以下提示词测试：

请概述当前项目的目录结构，并说明主要入口文件。

配置了多个 Provider 时，可使用以下命令切换模型：

/model custom:clawdrouter:YOUR_MODEL_ID

常见问题​

配置未生效​

确认 ~/.hermes/.env 中的变量名与 config.yaml 中的 key_env 完全一致，然后重启 Hermes Agent。

模型调用失败​

确认模型 ID 正确且当前 API Key 有调用权限。此配置使用 chat_completions 模式，对应 OpenAI Chat Completions 接口。

相关链接​