Hermes Agent 接入第三方 API 快速教程：安装、配置与模型验证
从安装 Hermes Agent 到配置第三方 OpenAI 兼容接口，本文带你在终端中跑通模型调用，并排查常见的 Key、Base URL 和模型名问题。
Hermes Agent 是一个面向本地和服务器环境的 AI Agent 工具。它可以在终端里和模型对话，也能继续接入飞书、Telegram 等外部聊天平台。由于 Hermes 支持 OpenAI 兼容接口，把它接到 NixAPI 后，就可以用一套 Key 调用 GPT、Claude、Gemini、DeepSeek、MiniMax 等模型。
本文只讲最短路径：安装 Hermes Agent，填入 NixAPI 的接口地址和 API Key，选择一个模型，然后确认终端对话能正常返回。
准备工作
开始前先准备：
- 一台 macOS、Linux 或 Windows 电脑
- 一个 NixAPI API Key
- 可以打开终端或 PowerShell 的本机账号
如果还没有 Key，先访问 NixAPI 首页 注册账号，再进入 NixAPI 控制台 创建 API Key。NixAPI 的接口兼容 OpenAI 格式，后面在 Hermes 里选择 OpenAI 或 OpenAI Compatible 类型即可。
如果你准备做较长时间的 Agent 测试，可以顺手看一下账户余额。NixAPI 当前有限时充值兑换率：￥0.80 = $1.00。
第一步：安装 Hermes Agent
macOS / Linux
打开终端，执行官方安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装脚本会处理运行时依赖。完成后让 shell 配置重新加载：
source ~/.zshrc
如果你使用的是 bash，可以改成：
source ~/.bashrc
Windows
用管理员身份打开 PowerShell，执行：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
安装过程中如果系统弹出安全确认，按提示允许即可。首次安装可能需要几分钟，取决于网络速度和本地依赖状态。
第二步：配置 NixAPI 作为模型供应商
在终端输入：
hermes config
进入配置向导后，找到模型供应商或 AI Provider 相关设置，按下面填写：
| 配置项 | 填写内容 |
|---|---|
| Provider 类型 | OpenAI 或 OpenAI Compatible |
| API Key | 你在 NixAPI 控制台创建的 Key |
| Base URL | https://nixapi.com/v1 |
这里最容易写错的是 Base URL。Hermes 调用 OpenAI 兼容接口时需要完整的 /v1 前缀，所以请填写：
https://nixapi.com/v1
如果配置向导没有提供 Base URL 输入框，也可以直接改配置文件：
- macOS / Linux：
~/.hermes/config.yaml - Windows：
%USERPROFILE%\.hermes\config.yaml
示例配置如下：
provider:
type: openai
api_key: nix-your-api-key
base_url: https://nixapi.com/v1
model: claude-sonnet-4-20250514
api_key 换成你的真实 NixAPI API Key。model 可以按需替换，建议从 NixAPI 支持的模型列表页 复制准确模型 ID。
第三步：选择模型并启动对话
配置完成后运行：
hermes model
确认当前模型是否正确。你可以先选择这些模型中的一个：
claude-sonnet-4-20250514claude-opus-4-7gpt-5.4gemini-3-pro-previewdeepseek-v4minimax-m3
模型 ID 必须和平台支持的名称一致。不同模型价格也不一样，正式使用前建议打开 NixAPI 模型价格页 确认。
随后启动 Hermes：
hermes
进入对话界面后，输入一个简单问题：
请把今天的待办事项整理成按优先级排序的清单。
如果 Hermes 能正常返回内容，说明安装、密钥、接口地址和模型配置已经跑通。
第四步：可选接入聊天平台
Hermes Agent 也可以通过 gateway 连接到聊天平台。以飞书为例，新开一个终端窗口执行：
hermes gateway setup
按提示选择 feishu，再填入你在飞书开放平台创建的应用信息，例如 App ID 和 App Secret。
Windows 用户如果遇到 lark-oapi 依赖缺失，注意要把依赖安装到 Hermes 使用的虚拟环境中，而不是系统 Python 里。找到 Hermes 的 venv 路径后执行：
<hermes-venv-path>/bin/pip install lark-oapi
常见问题
1. 报 401 Unauthorized 怎么办？
优先检查 API Key 是否复制完整、前后是否有空格，以及 NixAPI 账户是否可用。建议重新从 NixAPI 控制台 创建一个测试 Key 再试。
2. 报 404 Not Found 怎么办？
通常是 Base URL 写错。Hermes 这里应填写：
https://nixapi.com/v1
不要漏掉 /v1，也不要在末尾多加空格。
3. 提示 model not found 怎么办？
模型名不匹配。打开 NixAPI 支持的模型列表页，复制准确模型 ID 到 Hermes 配置里。
4. 想临时换模型怎么办？
可以在 Hermes 对话里使用 /model，也可以重新运行：
hermes model
如果你更习惯手动配置，直接修改 ~/.hermes/config.yaml 中的 model 字段也可以。
小结
Hermes Agent 负责本地 Agent 运行，NixAPI 提供统一的 OpenAI 兼容模型入口。配置完成后，你只需要维护一组 Base URL 和 API Key，就能在 Hermes 中切换不同模型。后续如果要做飞书机器人、Telegram 助手或自动化任务，可以继续基于同一套 NixAPI 配置扩展。