跳转到主要内容
🎉 限时免费 — MiniMax: MiniMax M3 Free 现在体验 🔥

Hermes Agent

Hermes Agent 是一款运行在终端中的 AI Agent。通过自定义 Provider，Hermes 可以使用 ModelGo 的 OpenAI 兼容接口调用模型。

接入前准备

  • 已安装 Node.js 22 或更高版本。
  • 已在 ModelGo 控制台创建 API Key。
  • 已在模型广场确认要使用的 ModelGo 逻辑模型名。

1. 安装 Hermes Agent

macOS 或 Linux：

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

Windows PowerShell：

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

重新打开终端后，检查安装是否成功：

bash
hermes --version

2. 配置 ModelGo

先把 API Key 放入当前终端的环境变量。不要把真实 Key 提交到代码仓库或公开脚本中：

bash
export MODELGO_API_KEY="你的-ModelGo-API-Key"
export MODELGO_MODEL="你的-ModelGo-逻辑模型名"

如果还不确定模型名，可以先查询当前 API Key 可用的模型：

bash
curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $MODELGO_API_KEY"

然后使用 hermes config set 写入自定义 Provider。将 <model> 替换为模型广场或 GET /v1/models 返回的逻辑模型名：

bash
hermes config set model.provider custom
hermes config set model.base_url https://api.modelgo.com/v1
hermes config set model.api_mode chat_completions
hermes config set model.api_key "$MODELGO_API_KEY"
hermes config set model.default "$MODELGO_MODEL"

如果你的 Hermes 版本通过 hermes model 提供配置向导，也可以运行：

bash
hermes model

选择 Custom endpoint，依次填写下方配置表中的 ModelGo Base URL、API Key 和模型名，并选择 Chat Completions 协议。

3. 检查配置并开始对话

检查 Hermes 配置：

bash
hermes config check

检查通过后启动 Hermes：

bash
hermes

输入一条消息，例如“用三句话介绍 ModelGo”。如果能返回模型结果，说明接入成功。

ModelGo 配置项

配置项ModelGo 填写内容
Providercustom
Base URLhttps://api.modelgo.com/v1
API 模式chat_completions
API Key在控制台创建的 ModelGo API Key
Model IDModelGo 的平台逻辑模型名，不是上游厂商原始模型 ID

Hermes 会将非敏感配置保存到 ~/.hermes/config.yaml，API Key 等敏感信息保存到 ~/.hermes/.env。不要分享或提交 ~/.hermes/ 下包含密钥的文件。

常见问题

返回 401 或提示认证失败

确认 API Key 没有被撤销或过期，并重新执行：

bash
hermes config set model.api_key "$MODELGO_API_KEY"

返回 403 或模型不可用

确认 model.default 使用的是 ModelGo 模型广场中、且当前 API Key 策略允许调用的逻辑模型名。

返回 404 或找不到接口

Base URL 应填写 https://api.modelgo.com/v1，不要再拼接 /chat/completions；Hermes 会在请求时补充具体路径。

相关文档