Skip to main content
通过 DeerAPI 为 Hermes Agent 配置自定义 OpenAI 兼容端点。完成配置后，你可以在 Hermes CLI 中直接调用 DeerAPI 的模型。

​
前提条件

  • Git
  • 可用的 DeerAPI API Key
  • macOS、Linux 或 WSL2 终端环境
1

获取 DeerAPI API Key

登录 DeerAPI 控制台，进入 API Key 页面并复制你的 <DEERAPI_KEY>。
DeerAPI 控制台中的 API Key 页面，添加 API Key 按钮高亮显示
DeerAPI API Key 列表页面
DeerAPI API Key 详情页，显示复制后的密钥信息
2

安装 Hermes Agent

下面的命令会执行官方安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
如果当前 shell 还没有识别 hermes 命令，重新加载 shell 配置：
source ~/.zshrc
# 或
source ~/.bashrc
Hermes 会把配置保存到 ~/.hermes/，并把 hermes 命令链接到 ~/.local/bin。安装脚本可能同时更新你的 shell PATH。
3

保存 DeerAPI API Key

打开 ~/.hermes/.env，加入以下内容：
OPENAI_API_KEY=<DEERAPI_KEY>
对于自定义 OpenAI 兼容端点，Hermes 会把 OPENAI_API_KEY 作为默认鉴权变量。
4

配置 DeerAPI 端点

打开 ~/.hermes/config.yaml，确认 model 段如下：
model:
  provider: custom
  default: your-model-id
  base_url: https://api.deerapi.com/v1
将 your-model-id 替换为 DeerAPI 定价页 上当前可用的文本模型 ID。
将 API Key 保留在 ~/.hermes/.env 中，不要把真实密钥写入 config.yaml。
这一步只配置主聊天模型。Hermes 的视觉、网页提取等辅助任务可以单独指定模型。
5

检查配置

下面的命令可以检查配置、鉴权和运行状态：
hermes config check
hermes doctor
hermes status
如果升级后提示缺少配置项，先运行 hermes config migrate，再重新检查。
6

执行真实对话测试

下面的命令会通过 DeerAPI 发起一次真实对话请求：
hermes chat -q "Reply with the single word CONNECTED."
成功时会返回 CONNECTED，且不会出现鉴权或端点错误。
如果你要替换旧版本 Hermes，先执行内置卸载：
hermes uninstall
在卸载界面选择 Full uninstall，移除 CLI、PATH 入口和 ~/.hermes/ 数据目录。然后重新执行安装步骤，再按本页完成配置。
如果你更想走交互式流程，运行 hermes model，然后选择 Custom endpoint。依次输入以下内容：
  • Base URL：https://api.deerapi.com/v1
  • API Key：你的 DeerAPI API Key
  • Model：当前可用的文本模型 ID
这个流程会把相同的 provider 配置写入 config.yaml。