注册
各种插件/软件使用教程 / Hermes Agent 配置教程

Hermes Agent 配置

通过 quickrouter-hermes 可以把 Hermes Agent 的模型后端切到 QuickRouter。配置完成后，Hermes 会使用 QuickRouter OpenAI 兼容 base_url，并通过一个 QuickRouter API Key 调用 Claude、GPT、DeepSeek、Gemini、Qwen 等 627+ 模型。

适合谁用

  • 已经安装 Hermes Agent，想直接接入 QuickRouter 的用户
  • 想在本地 Agent 中统一使用 QuickRouter 模型和额度的用户
  • 想用一条命令完成 OPENAI_API_KEY、OPENAI_BASE_URL 和默认模型配置的用户

前置条件

项目说明
Hermes Agent先在本机安装并确认 Hermes 可启动
QuickRouter 账号在 api.quickrouter.ai 注册
QuickRouter API Key建议为 Hermes 单独创建一个 sk-... token
模型权限在 token 里放行你准备在 Hermes 中使用的模型

一键配置

Linux / macOS / WSL2

curl -fsSL https://raw.githubusercontent.com/xujfcn/quickrouter-hermes/main/setup.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/xujfcn/quickrouter-hermes/main/setup.ps1 | iex

Windows CMD

curl -o setup.bat https://raw.githubusercontent.com/xujfcn/quickrouter-hermes/main/setup.bat
setup.bat

脚本会引导你输入 QuickRouter API Key、选择默认模型，并可选测试连接。

手动配置

如果你不想运行脚本，也可以手动写入 Hermes 配置文件。

环境变量

编辑 ~/.hermes/.env：

OPENAI_API_KEY=sk-your-quickrouter-key
OPENAI_BASE_URL=https://api.quickrouter.ai/v1

默认模型

编辑 ~/.hermes/config.yaml：

model:
  provider: "custom"
  default: "claude-opus-4-7"
  base_url: "https://api.quickrouter.ai/v1"

把 default 改成你在 QuickRouter token 中已放行的模型即可。

切换模型

配置完成后，可以在 Hermes 内随时用 /model 切换模型：

/model claude-opus-4-7
/model gpt-5.4
/model claude-sonnet-4-6
/model gemini-3.1-pro
/model deepseek-chat
/model qwen-max
/model gpt-4o

如果切换后返回 model not allowed 或 403，通常是当前 QuickRouter token 没有放行该模型。

验证清单

  • ~/.hermes/.env 中的 OPENAI_API_KEY 是有效的 QuickRouter token
  • OPENAI_BASE_URL 是 https://api.quickrouter.ai/v1
  • ~/.hermes/config.yaml 中 provider 为 custom
  • 默认模型已在 QuickRouter token 中放行
  • Hermes 中发送测试消息可以正常返回
  • /model gpt-5.4 或其他已放行模型可以切换成功

常见问题

现象常见原因处理方式
401 unauthorizedAPI Key 写错、过期或被重置重新生成 QuickRouter token 并更新 ~/.hermes/.env
403 / model not allowedtoken 未放行当前模型在 QuickRouter token 设置中放行对应模型
仍然走旧服务商Hermes 未读取新配置，或配置文件路径不对重启 Hermes，并检查 ~/.hermes/.env、~/.hermes/config.yaml
连接超时本机网络无法访问 QuickRouter检查网络代理、防火墙和 DNS

相关文档

Hermes Agent API 中转配置要点

如果你通过搜索“Hermes Agent 配置教程”“Hermes Agent API 中转”“Hermes Agent QuickRouter”进入本页，优先检查 API Key、Base URL 和模型 ID。多数调用失败都和这三个配置有关。

配置项填写建议常见问题
API Key填写 QuickRouter 控制台创建的密钥401 通常是 Key 错误、过期或额度不足
Base URL按本页工具要求填写 QuickRouter 接口地址；OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1Claude/Anthropic 类工具不一定带 /v1
模型 ID从价格页复制完整模型名model not found 通常是模型名或分组权限问题

常见排查方向

  • 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
  • 404 或 model not found：检查模型 ID 是否来自 QuickRouter 价格页，确认当前分组支持该模型。
  • 连接超时：确认工具里的 Base URL 没有多写路径或空格。
  • Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。

相关入口

常见问题

Hermes Agent 可以通过 QuickRouter API 接入大模型吗？

可以。只要 Hermes Agent 支持自定义 API Key、Base URL 或兼容 OpenAI/Claude 的接口，就可以按本页方式接入 QuickRouter。

Hermes Agent 的 Base URL 应该怎么填？

按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.quickrouter.ai/v1，Claude/Anthropic 类工具可能使用 https://api.quickrouter.ai。

Hermes Agent 提示 model not found 怎么办？

到 模型价格和分组 页面复制完整模型 ID，并确认 API Key 所在分组支持该模型。

← OpenClaw 最新版本 自定义中转站配置教程 N8N 工作流使用中转API 教程 →