Hermes Agent 接入 Models Hub:配置 Custom Endpoint
用 hermes model 交互菜单把 Custom Endpoint 指向 Models Hub,终端里的工具调用与技能都走 Models Hub 额度,附推荐模型与常见报错排查。
Hermes Agent 是 Nous Research 出品的开源终端 AI Agent,在终端里提供工具调用、文件读写和代码执行能力。它内置 Custom Endpoint 供应商类型,可以接入任意 OpenAI 兼容 API,全程通过交互式菜单完成,不用编辑配置文件或写代码。本文只讲接入,消息网关、技能商店等能力见官方文档。
三样东西
接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com/v1(必须以 /v1 结尾)、一个模型名。Hermes 要求所用模型至少支持 64K tokens 上下文,选择模型前请确认满足此要求。
准备
推荐模型
以下三个模型均满足 64K 以上上下文要求。
| 用途 | 模型名 | 定价 | 实时状态 |
|---|---|---|---|
| 日常终端任务首选 | claude-sonnet-4-6 | 查看价格 | 可用率与延迟 |
| 复杂推理与长上下文任务 | gpt-5.5 | 查看价格 | 可用率与延迟 |
| 便宜快速,适合简单任务 | gpt-5.4-mini | 查看价格 | 可用率与延迟 |
模型名以 模型定价页 为准。
配置步骤
-
安装 Hermes Agent:
Linux / macOS / WSL2:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashWindows(原生):
iex (irm https://hermes-agent.nousresearch.com/install.ps1)⚠️ Windows 原生支持以当前版本安装脚本为准,如遇问题可改用 WSL2 运行上方的 Linux 命令。安装完成后运行
hermes --version确认成功。 -
运行交互式配置菜单:
hermes model用方向键滚动到 Custom Endpoint,回车确认。
-
依次填入:
配置项 填什么 Base URL https://modelsok.com/v1,必须以/v1结尾API Key 你的 Models Hub API Key Model 上面推荐表里的模型名,需与 Models Hub 控制台模型 ID 完全一致 按提示确认保存。
验证
启动 Hermes 开始对话:
hermes或用 TUI 模式:hermes --tui。输入一句测试消息,例如「你好,告诉我今天星期几」,模型正常回复即接通。再打开 Models Hub 控制台的 用量日志,几秒内会出现一条对应模型名的请求,确认走的是 Models Hub。对话中输入 /model 可随时查看和切换当前模型。
常见报错
| 现象 | 原因 | 处理 |
|---|---|---|
| 回复为空或报错 | Base URL 没以 /v1 结尾 | 重新运行 hermes model 改成 https://modelsok.com/v1 |
| 提示模型不存在 | 模型名与 Models Hub 控制台的模型 ID 不完全一致 | 对照 定价页 核对拼写 |
| 提示 API Key 无效 | Key 复制不完整,或令牌被禁用 | 到 令牌页 重新生成后再次运行 hermes model |
| 提示 context 不够 | 换用的模型上下文小于 64K | 换成上方推荐表里的模型 |
| Windows 上安装失败 | 原生脚本对部分环境不兼容 | 改用 WSL2,在 WSL2 终端运行 Linux 安装命令 |
更多排查见 故障排查。
常见问题
计费方式? 按每次请求实际消耗的输入与输出 token 计费,价格看各模型定价页。
和直接用官方 API 有什么区别? Custom Endpoint 里填的地址、Key、模型名与直接对接厂商 API 完全一样,只是把域名换成了 Models Hub。
怎么切换模型? 对话中输入 /model,或再次运行 hermes model 覆盖之前的配置。