Hermes 接入

难度 ⌨️ 进阶　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

Hermes（爱马仕）是 Nous Research 开源的自进化 AI 智能体。它默认就是 OpenAI 兼容，把模型后端指向 Byesu 即可。

开始之前

先到 控制台 → 令牌 创建一个令牌（见 选择分组）。

第 1 步：配置（二选一）

方式一：命令向导（最省事）

hermes model

在服务商列表里选 Custom OpenAI-compatible endpoint（自定义 OpenAI 兼容端点），然后填：

• base URL：https://byesu.com/v1
• API key：你的 sk-xxxx
• 模型：Byesu 上的模型名（如 gpt-5.5、claude-opus-4-8）

方式二：手改配置文件

编辑 ~/.hermes/config.yaml 的 model: 段：

model:
  provider: "custom"               # 自定义 OpenAI 兼容端点
  base_url: "https://byesu.com/v1"
  default: "gpt-5.5"               # 改成 Byesu 上的模型名
  api_key: "sk-xxxx"               # 也可留空，改放进 ~/.hermes/.env

更安全：key 放 .env

不想把 key 写进配置文件，就放进 ~/.hermes/.env：

OPENAI_API_KEY=sk-xxxx

第 2 步：跑起来验证

配好后直接启动：

hermes

随便发一句话（比如「你好」），能正常回复就接通了 ✅

卡住了？

• 401 / 令牌无效 → key 填错（详情）
• 模型不存在 → default 的模型名要和 控制台 一致（详情）
• 无可用渠道 → 模型不在你令牌的分组里（选择分组，详情）
• 其它见 常见错误 & 解决