接入 Hermes

关于 Hermes

Hermes 是 Nous Research 的 Agent 工具，可以通过终端与模型对话，并调用工具完成任务。它支持在配置向导中添加自定义模型服务。

安装 Hermes

从 Hermes 官网下载安装程序，或按照官方安装指南安装命令行工具。

配置基元律动API

登录或注册基元律动账号，完成实名认证后在用户中心创建并保存 API Key。从模型页复制支持工具调用和 OpenAI Chat Completions 的模型 ID。当前 Hermes 官方文档要求 Agent 模型至少支持 64,000 tokens 上下文。

1. 打开模型配置向导

退出正在运行的 Hermes 会话，在终端执行：

hermes model

在提供商列表中选择 Custom endpoint（自定义接口）。不同版本的菜单编号可能不同，请按选项名称选择。

2. 填写 API 地址、密钥和协议

按终端提示填写以下信息，每输入一项后按回车确认：

输入地址和密钥后，Hermes 会尝试获取可用模型。在 Select API compatibility mode 中选择 Chat Completions，截图中对应编号为 2。

填写基元律动 API 地址和密钥，选择“Chat Completions”兼容模式

3. 选择模型

在 Select model 提示处，输入可用模型列表中的编号，或直接粘贴从基元律动模型页复制的模型 ID。

图中的 kimi-k2.6 仅作填写示例，模型列表和可用数量以当前账号实际返回的结果为准。

在“Select model”处选择模型，或直接输入模型 ID

4. 确认上下文与推理设置

在 Context length in tokens 提示处，可以直接回车留空，让 Hermes 尝试自动检测；也可以按所选模型实际支持的上下文长度填写。

截图中显示的是“未检测到，使用默认 256K”，并不代表模型实际支持 256K。 如果出现这种提示，请核对模型参数，必要时重新运行 hermes model 并填写正确的上下文长度。

在 Display name 提示处填写便于识别的名称，例如 TokenRhythm。看到 Saved to custom providers 表示提供商配置已经保存。

如果接下来出现 Select reasoning effort，按模型实际支持的推理选项选择。截图选择的是 Disable reasoning（关闭推理）；这只是示例选择，并非所有模型都需要关闭推理。需要保留当前设置时，可选择 Skip (keep current)。

确认上下文检测结果和显示名称，再按模型能力选择推理设置

5. 开始使用

配置完成后，在终端执行以下命令，开启新会话：

hermes

输入“请只回复：接入成功”发送测试消息。收到正常回复后，可在基元律动用户中心查看对应模型的调用记录。