Hermes 自定义模型接入
查看该工具的安装、自定义模型配置和验证方法。
使用前准备
- 可正常访问模型 API 的网络环境。
- 已获取 API Base URL。
- 已在本站 API Key 管理 创建可用的 API Key。
- 已在本站 模型广场 查看并复制模型 ID。
- Windows PowerShell，或 Linux、macOS、WSL2 终端。
安装 Hermes
根据操作系统选择对应命令。
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bashirm https://res1.hermesagent.org.cn/install.ps1 | iex安装完成后，重新打开终端并检查是否可用：
hermes --help配置 Hermes 模型
推荐优先使用交互式配置；需要管理多个模型服务时，再使用配置文件。
方式一：交互式配置（推荐）
在系统终端中运行：
hermes model选择：
Custom endpoint (self-hosted / VLLM / etc.)然后依次填写：
API base URL: https://api.do.top/v1API key: ${YOUR_API_KEY}Model name: ${YOUR_MODEL_ID}其中，${YOUR_API_KEY} 需要替换为你在模型服务平台创建的 API
Key；${YOUR_MODEL_ID} 需要替换为平台模型列表中的真实模型
ID，例如 GLM-5.2 或 Qwen3.6-27B。不要直接输入这两个占位符。
hermes model 需要在 PowerShell、命令提示符或其他系统终端中执行，不是在 Hermes 聊天输入框中执行。
方式二：使用配置文件
Hermes 用户配置目录通常为：
~/.hermes/建议将密钥保存在 .env 中，将模型和服务地址保存在 config.yaml 中。
编辑 ~/.hermes/.env：
MY_GATEWAY_API_KEY=${YOUR_API_KEY}编辑 ~/.hermes/config.yaml：
custom_providers: - name: ${PROVIDER_NAME} base_url: https://api.do.top/v1 key_env: MY_GATEWAY_API_KEY api_mode: chat_completionsmodel: provider: custom:${PROVIDER_NAME} default: ${YOUR_MODEL_ID}配置字段说明：
| 字段 | 是否必填 | 说明 |
|---|---|---|
name | 是 | 将 ${PROVIDER_NAME} 替换为自定义服务名称 |
base_url | 是 | 示例已自动填入当前站点的 API 基础地址，无需自行替换 |
key_env | 是 | .env 中保存 API Key 的环境变量名；需将 .env 示例中的 ${YOUR_API_KEY} 替换为真实API Key |
api_mode | 是 | OpenAI Chat Completions 兼容接口填写 chat_completions |
provider | 是 | 使用 custom:${PROVIDER_NAME} 选择上方定义的自定义服务 |
default | 是 | 默认使用的模型 ID；需将 ${YOUR_MODEL_ID} 替换为平台模型列表中的真实 ID，例如 GLM-5.2 或 Qwen3.6-27B |