Hermes Agent 工具连接 Taotoken 自定义提供商的具体配置方法

1. 准备工作

在开始配置之前，请确保您已经拥有有效的 Taotoken API Key。可以在 Taotoken 控制台的「API 密钥」页面创建和管理密钥。同时，您需要安装 Hermes Agent 工具的最新版本。

Hermes Agent 支持通过自定义提供商接入 Taotoken 平台，这需要正确设置 provider 类型、base_url 和 API Key。以下步骤将指导您完成整个配置过程。

2. 配置 provider 与 base_url

Hermes Agent 使用custom作为 provider 类型来对接 Taotoken 平台。关键的配置项是base_url，必须设置为https://taotoken.net/api/v1。请注意末尾的/v1是必须的，这与 OpenAI 兼容的 API 路径规范一致。

您可以通过以下两种方式之一进行配置：

1. 使用 Hermes Agent 的配置文件（通常是config.yml或settings.json）
2. 通过环境变量设置

推荐使用配置文件方式，因为它更易于管理和版本控制。在配置文件中，应包含如下关键字段：

provider: custom base_url: https://taotoken.net/api/v1

3. 设置 API Key

Taotoken 的 API Key 需要被正确设置才能通过身份验证。Hermes Agent 通常从环境变量OPENAI_API_KEY读取密钥。您可以通过以下方式设置：

1. 直接在命令行中设置临时环境变量：

export OPENAI_API_KEY=您的Taotoken_API_KEY

2. 更推荐的做法是将密钥写入.env文件：

echo "OPENAI_API_KEY=您的Taotoken_API_KEY" >> .env

重要安全提示：请确保不要将包含密钥的.env文件提交到版本控制系统。建议将.env添加到您的.gitignore文件中。

4. 选择模型

Taotoken 平台提供了多种模型可供选择。您可以在 Taotoken 的模型广场查看所有可用模型及其 ID。在 Hermes Agent 中，您可以通过以下方式指定模型：

1. 在配置文件中设置默认模型：

model: claude-sonnet-4-6

2. 或者在每次调用时通过命令行参数指定：

hermes --model claude-sonnet-4-6

5. 验证配置

完成上述配置后，建议运行一个简单的测试命令来验证配置是否正确：

hermes "你好"

如果配置正确，您应该能看到模型的响应输出。如果遇到任何错误，请检查：

• base_url 是否正确包含/v1
• API Key 是否正确且未被撤销
• 模型 ID 是否拼写正确
• 网络连接是否正常

6. 使用 TaoToken CLI 简化配置（可选）

如果您希望更快速地完成配置，可以使用 TaoToken 官方提供的 CLI 工具：

npx @taotoken/taotoken hermes --key YOUR_API_KEY

该命令会自动完成 Hermes Agent 所需的配置，包括设置正确的 base_url 和 API Key。更多细节可以参考 Hermes Agent 接入说明。

完成以上步骤后，您的 Hermes Agent 就已经成功连接到 Taotoken 平台，可以开始调用聚合模型服务了。如需进一步了解 Taotoken 的功能，请访问 Taotoken。