Hermes 配置教程

添加 QuickRouter 为自定义供应商,并选择 Hermes 使用的模型。

先安装 Hermes,并创建 QuickRouter API Key。

推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。

使用 QuickRouter Switch 配置

还没安装?下载并安装 QuickRouter Switch。

  1. 添加供应商

    打开 QuickRouter Switch,在左边选「Hermes」,点「添加供应商」。

  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    核对 Hermes 的 API 模式、端点和 API Key。
    图 17 核对 Hermes 的 API 模式、端点和 API Key。
    可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
    图 18 可换成自己实际要用的模型;填写当前 API Key 可调用的模型 ID。
  3. 添加并打开工具

    点右下角「添加」。若卡片还在「可添加」区,点卡片上的「添加」。在 QuickRouter 卡片的「更多」菜单里点「设为默认」。再运行 hermes chat。

查看具体参数和更多操作

「API 模式」保留「Anthropic Messages」,「API 端点」用 https://api.quickrouter.ai/v1,模型示例为 claude-sonnet-5-5。预填模型仅作示例,可换成自己实际要用的模型。请填写当前 API Key 可调用的完整模型 ID。 需要更换默认模型时,把要用的模型放在列表第一项。

填好后点右下角「添加」。如果 QuickRouter 仍在「可添加」区,再点卡片上的「添加」,使其进入「已添加」。 在「已添加」卡片的「更多」中选择「设为默认」。重新运行 hermes chat,用新会话确认实际模型。

使用 CC-Switch 配置

还没安装?下载并安装 CC-Switch。

  1. 添加供应商

    打开 CC Switch,在左侧选择Hermes,点击添加供应商,选择自定义配置。

  2. 填写连接信息
    • 供应商标识填 quickrouter,名称填 QuickRouter。
    • API 模式选 OpenAI Chat Completions,API 端点填 https://api.quickrouter.ai/v1,API Key 填自己的令牌。
    Hermes 的 OpenAI Chat Completions API 模式与模型列表
    Hermes:API 模式选 OpenAI Chat Completions,第一项模型为 gpt-6-sol。
  3. 设置模型
    • 模型列表第一项的 ID 填 gpt-6-sol,显示名称填 gpt-6-sol。

    示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。

  4. 保存供应商

    在表单底部点添加,确认 Hermes 的供应商列表出现 QuickRouter 卡片。

  5. 启用并打开工具

    本节直接写入客户端配置。

    如果卡片在「可添加」,先点添加。在「已添加」的 QuickRouter 卡片右侧点更多(⋯)→ 设为默认,确认卡片显示「默认」。Hermes 会使用配置中排在第一位的模型。

    在终端运行 hermes chat,输入 /new 新建会话。

    Hermes 的 CC Switch 供应商界面截图
    图中 QuickRouter 卡片已显示「默认」。如未设为默认,从卡片的「更多」菜单选择「设为默认」。
  6. 发送消息验证

    在 Hermes 新会话发送「请只回复 OK」。看到回复后,打开QuickRouter 使用日志,核对请求时间、模型 ID 和成功状态。

查看配置细节与排错

配置写入 ~/.hermes/config.yaml 的 custom_providers。切换为默认供应商后,检查 model.provider = quickrouter 与 model.default = gpt-6-sol。显示名称仅用于界面。本节直接使用 Chat 接口,无需 CC Switch 本地路由。

确认配置生效

打开 Hermes 的新会话,选择刚配置的模型,发送「请只回复 OK」。在 QuickRouter 使用日志核对发送时间和实际请求模型。遇到 401 或 403 时,先检查令牌和模型权限。

返回工具教程列表

查看原有安装、手动配置与排错

更新于

适用范围:Hermes Agent 的 custom 提供商与手动模型配置;一键脚本为独立 QuickRouter 辅助项目。

版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。未在真实账号中验证付费模型调用。

配置速查

配置项填写内容注意事项
OPENAI_API_KEYQuickRouter API Key写入 ~/.hermes/.env。
OPENAI_BASE_URLhttps://api.quickrouter.ai/v1与 config.yaml 的 base_url 一致。
model.providercustom手动选择自定义提供商。
model.defaultgpt-6-sol以当前模型权限为准。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

第 1 步:确认 Hermes 已安装

按 Hermes 官方说明安装并确认可以启动。本文介绍手动配置 custom 提供商。使用当前安装版本的官方配置说明核对设置。

第 2 步:配置本地凭据

编辑当前用户的 ~/.hermes/.env,合并以下变量,保留其他已有设置。

OPENAI_API_KEY=YOUR_QUICKROUTER_API_KEY
OPENAI_BASE_URL=https://api.quickrouter.ai/v1

第 3 步:配置默认模型与提供商

在 ~/.hermes/config.yaml 中修改 model 节点,不用片段覆盖整份文件。

model:
  provider: "custom"
  default: "gpt-6-sol"
  base_url: "https://api.quickrouter.ai/v1"

custom 提供商、OpenAI 兼容端点与模型须同时满足当前 Hermes 版本要求。

第 4 步:重启并核对实际后端

关闭已有 Hermes 进程后重新启动,先发一条短消息,再测试读取 README。若使用 /model 切换模型,重新确认实际提供商;只改模型名称不足以证明请求仍走同一个后端。

连接失败时按这几步排查

运行 hermes model 配置 Custom endpoint,API base URL 为 https://api.quickrouter.ai/v1;模型、provider 与 URL 应作为同一组设置。

  1. 退出当前会话,在终端运行 hermes model,选择 Custom endpoint,填写 Base URL、Key 和真实模型 ID。
  2. 保留 ~/.hermes/config.yaml 与 ~/.hermes/.env 的其他设置;检查 model.provider、model.default、model.base_url 是否对应同一服务。
  3. 新开会话确认实际 provider;会话内 /model 切换与终端 hermes model 添加提供商不是同一步操作。

容易混淆的情况

  • CLI、守护进程或其他运行环境可能读取不同环境变量;终端成功时仍需核对实际运行进程。
  • 短文本成功但 Agent 出错时,检查工具协议及上下文限制;上下文长度应按真实模型能力设置。

怎样确认修复成功

新会话先发短消息,再授权读取测试文件。若仍失败,查看本机 hermes logs,分享前删除密钥、私有提示词和敏感路径。

记录所装客户端版本、模型 ID、请求时间、最终路径与脱敏状态。本节为配置核对指南,未新增客户端付费调用实测;保留原文已有验证记录的适用范围。

打开 Hermes Agent 交互排错并下载检查记录 · 官方配置参考

怎样确认配置已生效

  1. 运行中的 Hermes 读取更新后的 .env 和 config.yaml。
  2. /model 显示目标模型,短消息有日志。

接入失败时逐项检查

现象检查与处理
切换后 model not allowed核对当前令牌允许的模型与分组。
手动修改没有生效重新启动 Hermes,确认配置目录和当前运行用户一致。
辅助脚本下载失败改用本页手动配置;不要将辅助脚本视为 Hermes 官方安装器。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。

在线客服