Post

Hermes Agent 接入第三方 API 中转站教程

Hermes Agent 是 Nous Research 推出的智能 AI 代理，支持接入自定义 LLM Provider。本文详细介绍如何将第三方 API 中转站（如 NewAPI / OneAPI）接入 Hermes Agent。 一、前置准备 1.1 你需要什么 物料 说明 Hermes Ag

阅读 1 点赞 0 评论 0

Hermes Agent 是 Nous Research 推出的智能 AI 代理，支持接入自定义 LLM Provider。本文详细介绍如何将第三方 API 中转站（如 NewAPI / OneAPI）接入 Hermes Agent。

一、前置准备

1.1 你需要什么

物料 说明
Hermes Agent 已安装并正常运行
中转站地址 如 https://api.ffmx.online/v1
API Key 中转站分配的 sk- 开头的密钥
模型名称 如 gpt-5.6-sol、claude-sonnet-4 等

1.2 确认中转站可用

在接入前，先用 curl 测试中转站是否正常：

curl -s https://api.ffmx.online/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "hi"}],
    "max_tokens": 10
  }'

返回正常的 JSON 响应即可继续。

curl 测试中转站

二、配置 Hermes Agent 接入中转站

2.1 找到配置文件

Hermes Agent 的配置文件位于：

系统 路径
macOS / Linux ~/.hermes/config.yaml
Windows C:\\Users\\你的用户名\\.hermes\\config.yaml

如果该文件不存在，可以手动创建，或运行 hermes init 初始化。

Hermes 配置目录

2.2 编辑 config.yaml

打开 config.yaml，找到 providers 部分，添加你的中转站：

providers:
  # 你的第三方中转站
  my-relay:
    base_url: "https://api.ffmx.online/v1"
    api_key: "sk-你的中转站key"
    models:
      - "gpt-5.6-sol"
      - "gpt-5.5"
      - "claude-sonnet-4"

2.3 设置默认模型

在 config.yaml 中指定默认使用的 provider 和模型：

# 默认 provider
default_provider: "my-relay"

# 默认模型
default_model: "gpt-5.6-sol"

providers:
  my-relay:
    base_url: "https://api.ffmx.online/v1"
    api_key: "sk-你的中转站key"
    models:
      - "gpt-5.6-sol"
      - "gpt-5.5"

保存后重启 Hermes 即可生效。

config.yaml 配置示例

三、通过环境变量接入（免写配置文件）

如果你不想修改 config.yaml，也可以通过环境变量快速接入：

3.1 macOS / Linux

# 设置环境变量
export HERMES_PROVIDER_BASE_URL="https://api.ffmx.online/v1"
export HERMES_PROVIDER_API_KEY="sk-你的中转站key"
export HERMES_MODEL="gpt-5.6-sol"

# 启动 Hermes
hermes

写入 shell 配置文件（永久生效）：

cat >> ~/.bashrc << 'EOF'
export HERMES_PROVIDER_BASE_URL="https://api.ffmx.online/v1"
export HERMES_PROVIDER_API_KEY="sk-你的中转站key"
export HERMES_MODEL="gpt-5.6-sol"
EOF

source ~/.bashrc

3.2 Windows（PowerShell）

# 临时设置（当前会话有效）
$env:HERMES_PROVIDER_BASE_URL = "https://api.ffmx.online/v1"
$env:HERMES_PROVIDER_API_KEY = "sk-你的中转站key"
$env:HERMES_MODEL = "gpt-5.6-sol"

# 启动 Hermes
hermes

永久设置（写入系统环境变量）：

[System.Environment]::SetEnvironmentVariable("HERMES_PROVIDER_BASE_URL", "https://api.ffmx.online/v1", "User")
[System.Environment]::SetEnvironmentVariable("HERMES_PROVIDER_API_KEY", "sk-你的中转站key", "User")
[System.Environment]::SetEnvironmentVariable("HERMES_MODEL", "gpt-5.6-sol", "User")

环境变量设置

四、多 Provider 配置（中转站 + 官方双通道）

Hermes 支持同时配置多个 Provider，可以灵活切换或做 Fallback：

default_provider: "my-relay"
default_model: "gpt-5.6-sol"

providers:
  # 主力：第三方中转站
  my-relay:
    base_url: "https://api.ffmx.online/v1"
    api_key: "sk-你的中转站key"
    models:
      - "gpt-5.6-sol"
      - "gpt-5.5"
      - "claude-sonnet-4"

  # 备用：OpenAI 官方
  openai-official:
    base_url: "https://api.openai.com/v1"
    api_key: "sk-你的官方key"
    models:
      - "gpt-4o"
      - "o1"

  # 备用2：Anthropic 官方
  anthropic:
    base_url: "https://api.anthropic.com/v1"
    api_key: "sk-ant-你的key"
    models:
      - "claude-sonnet-4"

运行时临时切换 Provider：

# 使用中转站
hermes --provider my-relay --model gpt-5.6-sol

# 切换到 OpenAI 官方
hermes --provider openai-official --model gpt-4o

五、验证接入是否成功

5.1 命令行验证

启动 Hermes 后发送一条消息，观察是否正常返回：

hermes "你好，请用中文回复"

正常返回中文回复即接入成功。

5.2 检查日志

如果出错，查看 Hermes 日志：

# macOS / Linux
cat ~/.hermes/logs/hermes.log | tail -20

# Windows
type C:\Users\你的用户名\.hermes\logs\hermes.log

六、FAQ 常见问题

Q1：提示 401 Unauthorized

  • 检查 API Key 是否正确、是否过期
  • 确认中转站地址末尾是否需要 /v1
  • 在中转站后台确认 Key 是否有对应模型的调用权限

Q2：提示 404 Not Found 或 model not found

  • 确认模型名称拼写正确（如 gpt-5.6-sol 而非 gpt5.6sol）
  • 在中转站后台确认该模型已添加到对应渠道
  • 尝试用 curl 直接请求中转站验证模型是否可用

Q3：提示 Connection refused 或 timeout

  • 检查网络是否能访问中转站地址
  • 如果在国内，可能需要配置代理：
    bash export HTTPS_PROXY=http://127.0.0.1:7890
  • 检查中转站是否正常运行

Q4：如何使用 Client 伪装绕过中转站限制

部分中转站会检测客户端 UA，拒绝非 Codex/Hermes 的请求。可以在请求头中伪装：

providers:
  my-relay:
    base_url: "https://api.ffmx.online/v1"
    api_key: "sk-你的key"
    headers:
      User-Agent: "codex_cli_rs/0.1.0"
      Originator: "codex"
      OpenAI-Beta: "responses=experimental"
    models:
      - "gpt-5.6-sol"

Q5：Hermes 支持哪些中转站协议

Hermes 兼容 OpenAI API 格式，因此任何兼容 OpenAI API 的中转站都可以接入：

中转站类型 兼容性 说明
NewAPI 完全兼容 推荐
OneAPI 完全兼容 推荐
直接 OpenAI 官方 完全兼容 base_url 填 https://api.openai.com/v1
Azure OpenAI 需额外配置 base_url 格式不同
自建反代 完全兼容 只要兼容 OpenAI API 格式即可

七、完整配置示例

一份完整的 config.yaml 示例：

# Hermes Agent 配置
default_provider: "ffmx"
default_model: "gpt-5.6-sol"

# 供应商列表
providers:
  # 主力中转站
  ffmx:
    base_url: "https://api.ffmx.online/v1"
    api_key: "sk-你的中转站key"
    headers:
      User-Agent: "codex_cli_rs/1.0"
    models:
      - "gpt-5.6-sol"
      - "gpt-5.5"
      - "claude-sonnet-4"

  # 备用 OpenAI 官方
  openai:
    base_url: "https://api.openai.com/v1"
    api_key: "sk-你的官方key"
    models:
      - "gpt-4o"

# 工具配置
tools:
  terminal: true
  browser: true
  file: true
  web_search: true

八、总结

步骤 操作
1. 测试中转站 curl 请求确认可用
2. 编辑 config.yaml 添加 provider + base_url + api_key + models
3. 设置默认模型 default_provider + default_model
4. 验证 运行 hermes 发消息测试
5. 按需配置多 Provider 支持 Fallback 和切换

接入第三方中转站后，Hermes 即可通过中转站调用多种 AI 模型，享受更低的成本和更灵活的模型选择。#hermes #教程 #中转站

A

作者

Administrator
↗

继续阅读

全部归档

评论