Hermes

外接说明

第三方客户端的更新进度与接口适配存在差异，可能遇到缓存未命中、工具无法调用等兼容性问题。追求最完整体验时，建议优先使用模型对应的官方客户端。

本教程通过编辑 Hermes 的 config.yaml 同时接入 GPT 与 Claude 模型。开始前请准备好令牌。

一、找到配置文件

不同系统的 HERMES_HOME 位置不同，配置文件均为该目录下的 config.yaml：

系统	配置文件位置
Windows	%LOCALAPPDATA%\hermes\config.yaml
macOS	~/.hermes/config.yaml
Linux	~/.hermes/config.yaml

如果文件还不存在，先启动一次 Hermes，让它生成配置目录和文件。

二、把配置追加到文件末尾

把下面整段追加到 config.yaml 的最底部：

# ===== 自定义第三方模型 =====

providers:
  # GPT / Codex
  wow3:
    api: https://api.wow3.top/v1
    api_key: sk-***
    transport: codex_responses
    models:
      gpt-6-astra:
        context_length: 272000
      gpt-5.6-sol:
        context_length: 272000

  # Claude
  wow3_claude:
    api: https://api.wow3.top
    api_key: sk-***
    transport: anthropic_messages
    models:
      claude-opus-5:
        context_length: 272000
      claude-sonnet-5:
        context_length: 272000

# 默认启动模型
model:
  default: gpt-6-astra
  provider: custom:wow3

# ===== 自定义配置结束 =====

三点注意

1. 只能追加到文件最后，不要删除 config.yaml 原有的任何配置项
2. sk-*** 是占位符，替换为你自己的令牌
3. 上面的模型名只是示例，以模型广场当前可用模型为准

三、字段说明

字段	含义
providers	自定义服务商的总配置区域
wow3 / wow3_claude	服务商名称，可自定义；GPT 与 Claude 必须用不同名称
api	接口地址。GPT / Codex 带 /v1，Claude 不带 /v1
api_key	你的令牌
transport	接口协议。codex_responses 对应 GPT / Codex，anthropic_messages 对应 Claude
models	该服务商下可用的模型列表
context_length	上下文长度，以模型实际支持为准
model.default	启动时默认选择的模型
model.provider	默认模型所属服务商，custom:wow3 指向上面的 wow3

四、验证

保存后重启 Hermes，在模型列表中选择需要的模型，发送一句 你好。收到正常回复即表示接入成功。

若请求失败，先确认：config.yaml 是否已保存、配置是否确实追加在文件末尾、地址与协议是否一一对应（/v1 有没有写反）。进一步排查见外接与兼容类问题。