跳转到主要内容
Hermes Agent 是面向本地终端工作流的 AI Agent。它可以作为日常开发助手使用，也可以结合技能、MCP、任务调度和子 Agent 处理更长的自动化任务。 接入 BetterToken 时，请使用 GPT 分组 API Key，并通过 OpenAI-compatible endpoint 调用模型。
本文仅覆盖 Hermes Agent 的 GPT 分组接入方式。模型 ID 请以模型广场显示为准。

​
前置条件

  • 已获取 BetterToken API Key（注册并获取）
  • API Key 属于 GPT 分组
  • 已从模型广场复制要使用的 GPT 分组模型 ID
  • macOS、Linux 或 Windows WSL2 环境

​
安装 Hermes Agent

​
配置步骤

1

运行模型选择器

2

选择 OpenAI 或 OpenAI Compatible provider

在 provider 列表中，选择 OpenAI 或 OpenAI Compatible。
3

填写 BetterToken 配置

按提示依次输入：
  • Base URL：https://www.bettertoken.ai/v1
  • API Key：你的 BetterToken API Key
  • Model：从模型广场复制的 GPT 分组模型 ID
4

重启 Hermes Agent

修改配置后，请退出当前 Hermes Agent 会话，再重新启动。
5

启动 Hermes Agent

​
功能速查

​
从 OpenClaw 迁移

如果你已经使用 OpenClaw，可以先在 Hermes Agent 当前版本中检查是否提供迁移命令。迁移前建议先做 dry run。
确认无误后再执行正式迁移：
迁移后仍建议检查 Hermes Agent 中的 Base URL、API Key 和模型 ID，确保它们分别对应 https://www.bettertoken.ai/v1、你的 BetterToken API Key，以及 GPT 分组模型 ID。

​
排障提示

  • 无响应或请求失败时，先确认 Base URL 是否正好是 https://www.bettertoken.ai/v1。这里通常不要再拼接 /chat/completions。
  • 报模型不存在时，确认 Model 是否来自模型广场中的 GPT 分组。
  • 报鉴权失败时，确认 API Key 没有复制空格，并且属于 GPT 分组。
  • 修改配置后仍走旧模型时，退出当前 Hermes Agent 会话并重新运行 hermes。
  • 接入 BetterToken 时通常不需要额外设置 User-Agent 或其他 headers。只有当你还接了自定义网关、租户路由、审计或缓存服务时，再按对应上游服务的官方文档补充。
请不要把真实 API Key 提交到仓库。团队共享配置时，优先使用环境变量或本机配置。

​
相关 FAQ