Hermes Agent

通过交互式自定义端点配置，将 Hermes Agent 接入 CoffeeRouter。

接入前准备

  • 在 CoffeeRouter 控制台创建一个可用令牌，并确认令牌允许使用目标聊天模型。
  • 记下模型 ID；Hermes 要求所选模型至少支持 64K 上下文。
  • 准备 CoffeeRouter API 地址 https://www.coffeerouter.ai/v1。

配置步骤

1. 安装 Hermes Agent

macOS、Linux、WSL2 或 Termux 使用官方安装脚本：

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

Windows PowerShell 可以原生安装：

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

根据安装器提示重新打开终端，或重新加载 Shell 配置，然后检查版本：

hermes --version

2. 添加 CoffeeRouter 自定义端点

运行模型配置向导：

hermes model

选择 Custom endpoint (self-hosted / VLLM / etc.)，然后填写：

配置项填写内容
API Base URLhttps://www.coffeerouter.ai/v1
API Keysk-your-api-key
ModelCoffeeRouter 中显示的模型 ID

3. 检查或手动编辑配置

向导会保存 Hermes 配置。如需检查，可打开 ~/.hermes/config.yaml，核心内容如下：

model:
    default: your-model-id
    provider: custom
    base_url: https://www.coffeerouter.ai/v1
    api_key: sk-your-api-key

模型 ID 必须与 CoffeeRouter 令牌可用模型列表中的名称完全一致。建议优先使用 hermes model 向导，避免破坏文件中的其他设置。

验证接入

启动 Hermes 并发送一条测试消息：

hermes

也可以启动终端界面：

hermes --tui

若能正常收到回复，且 /model 显示刚配置的模型，即表示接入成功。

常见问题

为什么模型配置后无法使用？

请确认模型 ID 与 CoffeeRouter 中显示的名称一致，并确认该模型至少支持 64K 上下文。Hermes 会拒绝上下文窗口过小的模型。

为什么请求返回 401？

请重新复制完整令牌，确认令牌已启用、未过期且仍有额度。不要在 API Key 前后添加空格或引号。

Windows 是否必须使用 WSL2？

不必须。Hermes 当前提供原生 PowerShell 安装脚本；如需 Linux 环境，也可以选择 WSL2。

为什么 Base URL 要带 /v1？

Hermes 的自定义端点需要填写 OpenAI 兼容 API 基础地址，CoffeeRouter 对应地址为 https://www.coffeerouter.ai/v1。

安全提示

CoffeeRouter 令牌等同于账户调用凭证。不要分享配置文件、终端截图或包含令牌的日志；建议为 Hermes 单独创建令牌，以便独立限制模型、额度和 IP，并在设备丢失或停用时及时撤销。

官方资料