智能体接入
Hermes 使用 Jerry API
Hermes 支持自定义 OpenAI-compatible 端点。密钥放在 ~/.hermes/.env，模型和地址放在 config.yaml。
1. 安装 Hermes Agent
macOS / Linux / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes --version2. 保存 API Key
编辑 ~/.hermes/.env，添加以下两行：
~/.hermes/.env
OPENAI_API_KEY=YOUR_JERRY_API_KEY
OPENAI_BASE_URL=https://www.jerryapi.com/v1限制文件权限
该文件包含密钥。在 macOS 或 Linux 上可执行 chmod 600 ~/.hermes/.env，并且不要将它同步到公开仓库。
3. 配置主模型
编辑 ~/.hermes/config.yaml，合并下面的模型配置：
~/.hermes/config.yaml
model:
default: gpt-5.4
provider: custom
base_url: https://www.jerryapi.com/v1base_url 存在时，Hermes 会直接调用该 OpenAI-compatible 端点，并使用 OPENAI_API_KEY 认证。
4. 检查并启动
Terminal
hermes config check
hermes config
hermes chat首次测试先让 Hermes 回答一个普通问题，再让它读取当前目录或执行一个低风险工具任务。完成后从 Jerry API 使用记录核对请求。
辅助任务也使用 Jerry API
Hermes 的压缩、网页提取或其他辅助任务可继承主模型。如果要明确指定轻量模型，可以在对应配置中使用相同端点：
~/.hermes/config.yaml · 示例
auxiliary:
compression:
provider: main
model: gpt-5.4-mini
web_extract:
provider: main
model: gpt-5.4-miniprovider: main 在辅助任务中表示沿用当前主端点和凭据，不应作为顶层主模型的 Provider 值。
切换模型与排查
修改默认模型
model:
default: gpt-5.5
provider: custom
base_url: https://www.jerryapi.com/v1| 现象 | 处理 |
|---|---|
| 找不到 API Key | 确认密钥位于 ~/.hermes/.env，变量名必须是 OPENAI_API_KEY |
| 仍在调用旧 Provider | 顶层模型必须设置 provider: custom，并重启 Hermes |
| 模型名无效 | 使用完整模型 ID，例如 gpt-5.4-mini，不要加 openai/ 前缀 |
| 辅助任务消费过高 | 将适合的辅助任务显式设置为 gpt-5.4-mini |