Esta página ainda está disponível apenas em chinês. A navegação e os menus já aparecem em português.

配置 Hermes

Hermes Agent 可以通过自定义 OpenAI-compatible Provider 接入 InOneAPI。推荐通过官方模型向导保存端点、凭据和模型。

推荐：使用官方向导

  1. 运行 hermes model，选择 Custom endpoint。
  2. 名称填 InOneAPI，Base URL 填 https://api.inoneapi.com/v1。
  3. 填入 InOneAPI API Key，API mode 选择 Chat Completions。
  4. 选择模型详情页中的 YOUR_MODEL_ID；自动发现未列出时手动输入 ID。
  5. 保存并选用该模型。已有会话可通过 /model 切换；Windows 推荐使用 WSL2。

向导会按当前版本保存凭据与 Provider，模型详情页不再生成 Hermes 配置文件。官方同时支持手动配置，但不同版本可能使用 model、旧版 custom_providers 列表或新版 providers 字典；这些结构不能直接混用。不要把 CC Switch 的 Provider 片段当作整个 config.yaml 覆盖。

验证配置

选择模型后执行一个只读任务，然后在控制台确认公共模型 ID、状态码、Token、成本和 Trace。再测试一次需要工具调用的简单任务，确认所选模型支持 Hermes 使用的工具格式。

常见问题

  • YAML 无法解析：使用空格缩进，不要混用 Tab。
  • 401：重新运行向导检查 API Key；手动设置过环境变量时检查旧值是否覆盖凭据。
  • 404：检查模型 ID 和 base_url 中的 /v1。
  • 工具调用失败：协议可用不代表模型具备工具能力，应更换模型或关闭相关工具。

建议为 Hermes 创建专用 Key，设置月度预算和模型白名单，以便从团队用量中单独识别自动化任务。

可选：通过 CC Switch 导入

在模型详情页选择本工具和 API Key，点击「打开 CC Switch 并导入」。使用 CC Switch 官方版本，导入链接已包含当前模型 ID，无需重新填写。确认导入后，按本工具的供应商启用与默认模型设置完成接入。若提示不支持该 app，请升级 CC Switch 或按本文手动接入。

导入链接只添加 Provider，不代表已设为默认模型或已成功请求。链接包含 API Key，请勿分享。手动接入与 CC Switch 接入二选一即可。

CC Switch 当前源码为 Hermes 生成 base_url、api_key、api_mode: chat_completions 和 models，使用 snake_case。导入后仍需通过 hermes model 或 /model 选用供应商及模型。

官方参考：Hermes AI Providers。

Hermes · Documentação · InOneAPI