为 Hermes Agent 配置 Taotoken 作为自定义模型提供方的指南

为 Hermes Agent 配置 Taotoken 作为自定义模型提供方的指南

1. 准备工作

在开始配置前，请确保已安装 Hermes Agent 并拥有有效的 Taotoken API Key。您可以在 Taotoken 控制台的「API 密钥」页面创建新密钥。同时，在「模型广场」中确认您希望使用的模型 ID，例如claude-sonnet-4-6或gpt-4-turbo。

Hermes Agent 支持通过环境变量或配置文件指定自定义模型提供方。本指南将介绍两种主流配置方式：通过 TaoToken CLI 工具快速配置，以及手动编辑环境变量文件。

2. 使用 TaoToken CLI 快速配置

TaoToken 官方提供了@taotoken/taotokenCLI 工具，可简化 Hermes Agent 的对接流程。安装与使用步骤如下：

npm install -g @taotoken/taotoken

安装完成后，运行以下命令启动交互式配置向导：

taotoken hermes

按提示输入您的 Taotoken API Key 和模型 ID。工具会自动完成以下配置：

• 在 Hermes Agent 的配置文件中设置provider为custom
• 将base_url设为https://taotoken.net/api/v1
• 将密钥写入.env文件的OPENAI_API_KEY变量

若需非交互式配置，可使用以下命令格式：

taotoken hermes --key YOUR_API_KEY --model YOUR_MODEL_ID

3. 手动配置步骤

如果您偏好手动配置，请按以下步骤操作：

1. 打开 Hermes Agent 的配置文件（通常位于~/.hermes/config.json或项目根目录的hermes.config.json）
2. 添加或修改以下字段：

{ "provider": "custom", "base_url": "https://taotoken.net/api/v1", "model": "YOUR_MODEL_ID" }

3. 在项目根目录的.env文件中设置环境变量：

OPENAI_API_KEY=YOUR_API_KEY

4. 验证配置

完成配置后，可通过以下命令测试连接是否正常：

hermes chat "Hello, world"

如果返回预期的模型响应，则说明配置成功。若遇到问题，请检查：

• base_url是否包含/v1后缀
• API Key 是否正确且未过期
• 模型 ID 是否与 Taotoken 模型广场中的标识完全一致

5. 进阶配置提示

对于团队协作场景，建议将.env文件加入.gitignore，避免密钥泄露。您可以通过 CI/CD 环境变量或密钥管理工具注入OPENAI_API_KEY。

如需在不同项目中使用不同模型，可在各项目的 Hermes 配置文件中单独指定model参数，而保持base_url不变。例如：

{ "provider": "custom", "base_url": "https://taotoken.net/api/v1", "model": "claude-haiku-3-0" }

如需了解更多 Taotoken 支持的模型与功能，请访问 Taotoken。