集成

Hermes Agent

Nous Research 出品的 Hermes Agent 接入 xAPI —— 通过 hermes config 命令配置自定义 endpoint。

Hermes Agent 是 Nous Research 出品的 自我进化 AI agent,支持通过 CLI 命令配置任意 OpenAI 兼容 endpoint。 xAPI 接受 Authorization: Bearer,与 Hermes 默认行为完全兼容。

Hermes 要求所选模型的上下文窗口至少 64K tokens。 xAPI 默认支持的 Claude / GPT-5 系列均满足这一要求。

1

安装

参考 Hermes 官方文档: hermes-agent.nousresearch.com/docs。

2

创建 API Key

进入 xapi.to 控制台 → API Keys → 新建, 密钥形如 sk-xapi-...。

3

配置(选交互式或命令式)

$hermes model

在 provider 选择菜单中选 Custom Endpoint,按提示输入:

提示输入
Base URLhttps://ai.xapi.to/v1
API Keysk-xapi-...
Modelclaude-opus-4-7(或其他 xAPI 支持的模型)
4

启动与验证

$hermes --tui

在 TUI 中确认:

  • 顶部 model 显示 claude-opus-4-7
  • 发送一句 “hi” 收到回复 = 接入成功

控制台 → Usage Records 可查看本次调用。

锁定到特定上游(可选)

更换 OPENAI_BASE_URL:

上游base URL
SkyAPI(模型最全)https://skyapi.p.xapi.to/v1
SuperToken Max(官方源)https://supertoken-max.p.xapi.to/v1
SuperToken 逆向(成本最低)https://supertoken.p.xapi.to/v1

切换模型

$hermes config set model claude-sonnet-4-6

可用模型清单参见 模型与价格。Hermes 要求 ≥64K 上下文, 所有 xAPI 默认模型均满足。

常见问题

Hermes 强制要求模型的 contextWindow ≥ 64000。若提示不满足, 改用大上下文模型(claude-opus-4-7、claude-sonnet-4-6 等)。

hermes config set OPENAI_API_KEY 写入的密钥未生效。 检查 ~/.hermes/.env 中的值。

OPENAI_BASE_URL 缺少 /v1 后缀。 正确格式:https://ai.xapi.to/v1。

Hermes 的 skills 持久化在本地,不上传 xAPI。 切换 base URL 不影响已积累的 skill 与对话历史。