⌘K

Hermes

概述

Hermes 支持自定义 OpenAI 兼容 provider. 将 Vtrix 添加为 named custom provider, 在 Hermes 的 .env 文件中保存 Vtrix API Key, 再在 config.yaml 中选择 Vtrix 模型即可.

环境要求

  • Hermes Agent
  • Vtrix API Key, 在 设置 中创建
可选：使用 Vtrix Doctor

也可以先使用 Vtrix Doctor 检查本机 Base URL、API Key 和模型配置。已支持的工具，包括 OpenClaw 和 Hermes，可在确认后一键写入配置。

配置步骤

1

安装 Hermes

• 使用官方安装脚本

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后运行：

hermes --version
2

保存 Vtrix API Key

Hermes 将密钥放在 ~/.hermes/.env. 创建或编辑该文件：

mkdir -p ~/.hermes
vim ~/.hermes/.env

加入：

VTRIX_API_KEY=YOUR_VTRIX_API_KEY
3

添加 Vtrix custom provider

创建或编辑 ~/.hermes/config.yaml：

vim ~/.hermes/config.yaml

加入 Vtrix provider, 并设置为当前模型 provider：

custom_providers:
  - name: vtrix
    base_url: https://cloud.vtrix.ai/llm
    key_env: VTRIX_API_KEY

model:
  provider: custom:vtrix
  default: gpt-5.5
Base URL

Vtrix 的 OpenAI 兼容 Base URL 使用 https://cloud.vtrix.ai/llm. Hermes 会从 ~/.hermes/.env 中的 VTRIX_API_KEY 读取密钥.

4

切换模型

如需切换模型, 只修改 model.default.

类型示例模型说明
高性能gpt-5.5通用代码与推理能力较强
标准gpt-5.4日常开发, 均衡
Qwenqwen3.7-max同样通过 Vtrix Base URL 路由
提示

也可以运行 hermes model, 选择 custom endpoint, 按交互提示填入同样的 Vtrix Base URL 和模型 ID.

5

启动 Hermes

进入项目目录并启动 Hermes：

cd /path/to/your/project
hermes

也可以先做配置检查：

hermes doctor

如果 Hermes 能正常回复, 说明请求已通过配置的 custom provider 路由到 Vtrix. 也可在 Vtrix 设置 中查看账单或用量.

故障排查

报错：401 Unauthorized

原因： VTRIX_API_KEY 未设置、设置错误, 或 Hermes 没有从 ~/.hermes/.env 加载到密钥.

处理：

grep VTRIX_API_KEY ~/.hermes/.env

确认密钥存在后, 重新启动 Hermes.

Unknown provider 或找不到 custom provider

原因： model.provider 与 custom provider 名称不一致.

处理： 确认 provider 名称为 vtrix, 且当前选中的 provider 为 custom:vtrix：

custom_providers:
  - name: vtrix

model:
  provider: custom:vtrix
报错：model not found

原因： model.default 与 Vtrix 模型 ID 不一致.

处理： 前往 模型页面 复制正确的模型 ID, 然后更新 model.default.

Hermes 未读取新配置

原因： Hermes 已经在运行, 或其他配置覆盖了当前模型设置.

处理： 完全退出 Hermes, 重新启动, 并运行：

hermes config
hermes doctor

确认当前 provider 是 custom:vtrix, Base URL 是 https://cloud.vtrix.ai/llm.