接入 Hermes

Hermes Agent 是 Nous Research 推出的智能代理工具，支持终端和桌面使用方式，能够调用工具、执行多步骤任务，并连接自定义模型供应商。

Hermes 可通过 Better Gate 客户端、CC Switch 或手动配置接入 Better Gate。请选择其中一种方式，不要同时使用，以免不同工具写入的配置相互覆盖。

1 安装 Hermes

Hermes 支持 Windows、macOS、Linux 和 WSL2。更多安装和使用说明，请查看 Hermes Agent 官网；需要桌面版时，可从官网的 Desktop 入口下载安装程序。

1.1 Windows

打开 PowerShell，运行：

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

1.2 macOS

打开终端，运行：

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

1.3 Linux 或 WSL2

打开终端，运行与 macOS 相同的官方安装脚本。

安装过程会下载多项依赖，在网络受限环境下可能需要较长时间。完成后运行：

hermes --version

开始配置 Better Gate 前，请退出 Hermes 桌面应用和所有 CLI 会话。

2 准备 Better Gate 配置

登录 Better Gate 控制台。
确认账户有可用余额（组织成员需确认自己的成员额度够用）。
打开“API Keys”，点击“创建 Key”。
填写 Key 名称，路由方式保持默认的“智能路由”就行，它会自动挑可用渠道；只有需要固定渠道时才选“指定渠道分组”。组织管理员为成员创建 Key，记得勾选“分配给成员”。
点击创建，复制并保存好完整的 API Key。
打开“模型列表”，复制准备使用的模型 ID。

Hermes 使用 OpenAI Chat Completions 兼容接口。请选择支持工具调用的模型，以确保代理功能能够正常工作。

3 选择接入方式

3.1 通过 Better Gate 客户端接入 Hermes (推荐)

下载并安装 Better Gate 客户端：

系统	下载地址
Windows	下载 Better Gate Windows 客户端
macOS	下载 Better Gate macOS 客户端

安装并启动客户端，点击“登录”。
浏览器打开授权页面后，确认当前账号并点击“授权并继续”，随后返回客户端。

Better Gate 客户端主界面

通过客户端接入 Hermes：

Hermes 支持同时连接多把 API Key，接入弹窗按密钥独立管理，不是选一把 Key 就完成。

完整退出 Hermes 桌面应用和所有 CLI 会话。
找到 Hermes 卡片，点击“一键接入”（已经接入过至少一把密钥时，按钮会显示“管理接入 (n)”，打开的是同一个弹窗）。
在弹窗的密钥列表中，找到要使用的 API Key，点击这一行的“添加”；如果列表未更新，点击“刷新密钥”。
在模型列表中勾选一个或多个模型，点击“确认添加”。
需要接入其他密钥或模型时，重复第 3、4 步；全部完成后点击“完成”关闭弹窗。

不再需要某把密钥时，点击它这一行的“移除”即可断开；如果该密钥的模型是 Hermes 当前的默认模型，“移除”按钮会被禁用，需要先在 Hermes 里更换默认模型，再回来移除。

3.2 通过 CC Switch 接入 Hermes

前往 CC Switch Releases 下载并安装 CC Switch。

添加 Better Gate 供应商：

打开 CC Switch，在顶部工具栏中选择“Hermes”。
点击右上角的“+”。
填写以下内容：

字段	值
供应商标识	`better-gate`
供应商名称	`Better Gate`
官网链接	`https://better-gate.com/`，可选
API 模式	`OpenAI Chat Completions`
API 端点	`https://gateway.better-gate.com/v1`
API Key	你的 Better Gate API Key

在“模型列表”区域点击“获取模型列表”。如果自动获取失败，点击“添加模型”，手动填写模型 ID 和显示名称。保存后，在 Better Gate 卡片中点击“启用”。

3.3 手动配置 Hermes

Hermes 的默认配置目录如下：

macOS、Linux：~/.hermes/
Windows：%USERPROFILE%\.hermes\

在该目录中创建或编辑 .env：

BETTER_GATE_API_KEY=YOUR_BETTER_GATE_API_KEY

macOS 或 Linux 可运行 chmod 600 ~/.hermes/.env 限制文件权限。

创建或编辑 config.yaml：

custom_providers:
  - name: better-gate
    base_url: https://gateway.better-gate.com/v1
    key_env: BETTER_GATE_API_KEY
    api_mode: chat_completions

model:
  default: YOUR_MODEL_ID
  provider: custom:better-gate

如果文件中已有 custom_providers 或 model，请合并字段，不要重复创建同名 YAML 键。

完成任一接入方式后，重新启动 Hermes。需要选择供应商时运行 hermes setup，选择 better-gate 和目标模型，然后运行 hermes。发送一条简短消息，再前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。

如果提示 Unknown provider，请检查 YAML 缩进和 provider: custom:better-gate；如果无法读取 API Key，请确认 .env 中的变量名与 key_env 完全一致，并运行 hermes doctor 排查。

On this page