重点信息
准备工作
工具特定要求
- 所选 Model ID 来自 受支持提供商
- macOS、Linux 或 Windows WSL2 环境
安装
安装 Hermes Agent
- macOS / Linux / WSL2
- Windows
手动配置
主要通过 Hermes Agent 的交互式模型配置界面完成设置；命令行和环境变量方式作为可选方案保留。配置步骤
- 交互式配置
- 命令行配置
- 环境变量
1
运行模型选择器
2
选择 OpenAI 或 OpenAI Compatible provider
在 provider 列表中，选择 OpenAI 或 OpenAI Compatible。
3
填写 BetterToken 配置
按提示依次输入：
- Base URL：
https://bettertoken.ai/v1 - API Key：你的 BetterToken API Key
- Model：从模型广场复制的 受支持提供商的模型 ID
4
重启 Hermes Agent
修改配置后，请退出当前 Hermes Agent 会话，再重新启动。
5
启动 Hermes Agent
验证连接
发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。切换模型
打开模型选择器，或修改配置中的Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。
常见错误
排障提示
- 无响应或请求失败时，先确认 Base URL 是否正好是
https://bettertoken.ai/v1。这里通常不要再拼接/chat/completions。 - 报模型不存在时，确认 Model 是否来自模型广场中的 受支持提供商。
- 报鉴权失败时，确认 API Key 没有复制空格，并检查 Model ID 来自 受支持提供商。
- 修改配置后仍走旧模型时，退出当前 Hermes Agent 会话并重新运行
hermes。 - 接入 BetterToken 时通常不需要额外设置
User-Agent或其他 headers。只有当你还接了自定义网关、租户路由、审计或缓存服务时，再按对应上游服务的官方文档补充。
请不要把真实 API Key 提交到仓库。团队共享配置时，优先使用环境变量或本机配置。
相关 FAQ
- MCP 和 API Key / Base URL 有什么区别？
- Codex CLI 中 model_provider、base_url 和 wire_api 是什么？
- Cline 如何配置 OpenAI-compatible API？
- OpenClaw 接入 BetterToken 指南
进阶配置
支持的提供商
状态仅针对本页介绍的 BetterToken 接入方式。
配置方式说明
配置方式说明
- 手动配置：填写 API Key、Base URL 和 Model。
- 不支持：当前没有经过验证的直接配置方式。
技术说明
协议、endpoint 与 provider 内部字段
协议、endpoint 与 provider 内部字段
本页配置使用 确认无误后再执行正式迁移：迁移后仍建议检查 Hermes Agent 中的 Base URL、API Key 和模型 ID，确保它们分别对应
https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。功能速查
从 OpenClaw 迁移
如果你已经使用 OpenClaw，可以先在 Hermes Agent 当前版本中检查是否提供迁移命令。迁移前建议先做 dry run。https://bettertoken.ai/v1、你的 BetterToken API Key，以及 受支持提供商的模型 ID。