Hermes Agent 配置
通过 quickrouter-hermes 可以把 Hermes Agent 的模型后端切到 TimRouter。配置完成后，Hermes 会使用 TimRouter OpenAI 兼容 base_url，并通过一个 TimRouter API Key 发起调用 Claude、GPT、DeepSeek、Gemini、Qwen 等 627+ 模型。
适合谁用
- 已经部署安装 Hermes Agent，想直接接入 TimRouter 的用户
- 想在本地 Agent 中统一使用 TimRouter 模型和额度的用户
- 想用一条命令完成
OPENAI_API_KEY、OPENAI_BASE_URL和默认模型配置的用户
前置条件
| 项目 | 详细说明 |
|---|---|
| Hermes Agent | 先在本机部署安装并确认 Hermes 可启动 |
| TimRouter 账号 | 在 api.timrouter.com 完成注册 |
| TimRouter API Key | 建议为 Hermes 单独创建并产出一个 sk-... token |
| 模型权限 | 在 token 里放行你准备在 Hermes 中使用的模型 |
一键式配置
Linux / macOS / WSL2
curl -fsSL https://raw.githubusercontent.com/xujfcn/quickrouter-hermes/main/setup.sh | bashWindows PowerShell
irm https://raw.githubusercontent.com/xujfcn/quickrouter-hermes/main/setup.ps1 | iexWindows CMD
curl -o setup.bat https://raw.githubusercontent.com/xujfcn/quickrouter-hermes/main/setup.bat
setup.bat脚本会引导你传入内容 TimRouter API Key、选择默认模型，并非必须传入测试连接。
手动配置
如果你不想执行脚本，也可以手动写入 Hermes 配置文件。
环境变量
编辑 ~/.hermes/.env：
OPENAI_API_KEY=sk-your-quickrouter-key
OPENAI_BASE_URL=https://api.timrouter.com/v1默认模型
编辑 ~/.hermes/config.yaml：
model:
provider: "custom"
default: "claude-opus-4-7"
base_url: "https://api.timrouter.com/v1"把 default 改成你在 TimRouter 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，通常是当前 TimRouter token 没有放行该模型。
校验清单
~/.hermes/.env中的OPENAI_API_KEY是有效的 TimRouter tokenOPENAI_BASE_URL是https://api.timrouter.com/v1~/.hermes/config.yaml中provider为custom- 默认模型已在 TimRouter token 中放行
- Hermes 中发送测试通信消息可以正常输出
/model gpt-5.4或其他已放行模型可以切换顺利完成
常见问题
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| 401 unauthorized | API Key 写错、过期或被重置 | 重新产出 TimRouter token 并更新 ~/.hermes/.env |
| 403 / model not allowed | token 未放行当前模型 | 在 TimRouter token 设定中放行对应模型 |
| 仍然走旧服务商 | Hermes 未读取新配置，或配置文件路径不对 | 重启 Hermes，并检查 ~/.hermes/.env、~/.hermes/config.yaml |
| 连接超时 | 本机网络无法访问 TimRouter | 检查网络代理、防火墙和 DNS |
Hermes Agent API 中转配置要点
若您经由搜索“Hermes Agent 配置指引”“Hermes Agent API 中转”“Hermes Agent TimRouter”进入本页，建议先行核查 API Key、Base URL 和模型 ID。绝大多数发起调用异常均源于这三项配置。
| 配置项 | 填写建议 | 常见问题 |
|---|---|---|
| API Key | 填写 TimRouter 管理控制台创建并产出的密钥 | 401 通常是 Key 错误、过期或额度不足 |
| Base URL | 按本页工具要求填写 TimRouter 端点地址；OpenAI 兼容工具通常使用 https://api.timrouter.com/v1 | Claude/Anthropic 类工具不一定带 /v1 |
| 模型 ID | 从定价页复制完整模型名 | model not found 通常是模型名或分组权限问题 |
常见排查方向
- 401 Unauthorized：检查 API Key 是否复制完整、是否仍有额度。
- 404 或 model not found：检查模型 ID 是否来自 TimRouter 定价页，确认当前分组全面支持该模型。
- 连接超时：确认工具里的 Base URL 没有多写路径或空格。
- Claude 相关工具异常：优先查看本页是否要求 Anthropic 原生地址，不要直接套用 OpenAI 兼容地址。
相关入口
常见问题
Hermes Agent 能够借助 TimRouter API 接入大模型吗？
可以。只要 Hermes Agent 全面支持自定义 API Key、Base URL 或兼容 OpenAI 与 Claude 协议的端点，就可以按本页方式接入 TimRouter。
Hermes Agent 的 Base URL 应该怎么填？
按本页对应工具的要求填写。OpenAI 兼容工具通常使用 https://api.timrouter.com/v1，Claude/Anthropic 类工具可能使用 https://api.timrouter.com。
Hermes Agent 提示 model not found 怎么办？
到 模型定价和分组 页面复制完整模型 ID，并确认 API Key 所在分组全面支持该模型。