Hermes Agent 配置
官方入口：Hermes Agent 官网安装入口
本教程说明如何手动把 Hermes Agent 的模型后端切到巨蓝鲸AI。配置完成后，Hermes 会使用 巨蓝鲸AI OpenAI 兼容 base_url，并通过一个 巨蓝鲸AI API Key 调用 deepseek-v4-pro、deepseek-v4.1-flash、glm-5.3 三种模型。
适合谁用
- 已经安装 Hermes Agent，想直接接入 巨蓝鲸AI 的用户
- 想在本地 Agent 中统一使用 巨蓝鲸AI 模型和额度的用户
- 想手动配置
OPENAI_API_KEY、OPENAI_BASE_URL和默认模型的用户
前置条件
| 项目 | 说明 |
|---|---|
| Hermes Agent | 先在本机安装并确认 Hermes 可启动 |
| 巨蓝鲸AI 账号 | 在 api.julanjing.com 注册 |
| 巨蓝鲸AI API Key | 建议为 Hermes 单独创建一个 sk-... token |
| 模型权限 | 在 token 里放行你准备在 Hermes 中使用的模型 |
配置步骤
在 Hermes 配置文件中填写巨蓝鲸AI的 API Key 和接口地址。
环境变量
编辑 ~/.hermes/.env：
OPENAI_API_KEY=sk-your-julanjing-key
OPENAI_BASE_URL=https://api.julanjing.com/v1默认模型
编辑 ~/.hermes/config.yaml：
model:
provider: "custom"
default: "glm-5.3"
base_url: "https://api.julanjing.com/v1"把 default 改成你在 巨蓝鲸AI token 中已放行的模型即可。
切换模型
配置完成后，可以在 Hermes 内随时用 /model 切换模型：
/model glm-5.3
/model glm-5.3
/model deepseek-v4.1-flash
/model glm-5.3
/model deepseek-v4.1-flash
/model glm-5.3
/model deepseek-v4.1-flash如果切换后返回 model not allowed 或 403，通常是当前 巨蓝鲸AI token 没有放行该模型。
验证清单
~/.hermes/.env中的OPENAI_API_KEY是有效的 巨蓝鲸AI tokenOPENAI_BASE_URL是https://api.julanjing.com/v1~/.hermes/config.yaml中provider为custom- 默认模型已在 巨蓝鲸AI token 中放行
- Hermes 中发送测试消息可以正常返回
/model glm-5.3或其他已放行模型可以切换成功
常见问题
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| 401 unauthorized | API Key 写错、过期或被重置 | 重新生成 巨蓝鲸AI token 并更新 ~/.hermes/.env |
| 403 / model not allowed | token 未放行当前模型 | 在 巨蓝鲸AI token 设置中放行对应模型 |
| 仍然走旧服务商 | Hermes 未读取新配置，或配置文件路径不对 | 重启 Hermes，并检查 ~/.hermes/.env、~/.hermes/config.yaml |
| 连接超时 | 本机网络无法访问 巨蓝鲸AI | 检查网络代理、防火墙和 DNS |
Hermes Agent API 中转配置要点
如果你通过搜索“Hermes Agent 配置教程”“Hermes Agent API 中转”“Hermes Agent 巨蓝鲸AI”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。
| 配置项 | 填写建议 | 常见问题 |
|---|---|---|
| API Key | 填写 巨蓝鲸AI 控制台创建的密钥 | 401 通常是 Key 错误、过期或额度不足 |
| Base URL | 按本页工具要求填写 巨蓝鲸AI 接口地址；OpenAI 兼容工具通常使用 https://api.julanjing.com/v1 | Claude/Anthropic 类工具不一定带 /v1 |
| 模型 ID | 从价格页复制完整模型名 | model not found 通常是模型名或分组权限问题 |
常见排查方向
- 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
- 404 或 model not found：检查模型 ID 是否来自 巨蓝鲸AI 价格页，确认当前分组支持该模型。
- 连接超时：确认工具里的 Base URL 没有多写路径或空格。
- Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。
相关入口
- API 中转站说明
- OpenAI API 中转配置
- Claude API 国内使用
- Gemini API 国内使用
- 模型价格和分组
常见问题
Hermes Agent 可以通过 巨蓝鲸AI API 接入大模型吗？
可以。只要 Hermes Agent 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 巨蓝鲸AI。
Hermes Agent 的 Base URL 应该怎么填？
按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.julanjing.com/v1，Claude/Anthropic 类工具可能使用 https://api.julanjing.com。
Hermes Agent 提示 model not found 怎么办？
到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。