使用 Hermes Agent 时如何配置 Taotoken 作为自定义供应商

使用 Hermes Agent 时如何配置 Taotoken 作为自定义供应商

1. 准备工作

在开始配置前，请确保已安装 Hermes Agent 并具备基本的运行环境。同时需要在 Taotoken 控制台获取有效的 API Key，并在模型广场确认要使用的模型 ID。这两个信息将在后续配置中用到。

2. 配置 Taotoken 作为自定义供应商

Hermes Agent 支持通过自定义供应商接入第三方模型平台。以下是具体配置步骤：

1. 打开 Hermes Agent 的配置文件（通常为项目根目录下的config.yml或.hermes/config.yml）。
2. 找到providers配置节，添加或修改如下内容：

providers: custom: base_url: https://taotoken.net/api/v1 api_key: ${TAOTOKEN_API_KEY}

注意base_url必须包含/v1后缀，这是与 OpenAI 兼容 API 交互的必要路径。

3. 设置环境变量

为安全起见，建议将 API Key 存储在环境变量中而非直接写入配置文件。在项目根目录创建或编辑.env文件，添加以下内容：

TAOTOKEN_API_KEY=your_api_key_here

然后在 Hermes Agent 配置中通过${TAOTOKEN_API_KEY}引用该变量。确保.env文件已添加到.gitignore中以避免敏感信息泄露。

4. 指定模型与默认供应商

在 Hermes Agent 的配置文件中，还需要指定默认使用的模型和供应商。在models配置节中添加：

models: default: taotoken/claude-sonnet-4-6

这里的模型 ID 格式为taotoken/前缀加上在 Taotoken 模型广场查看到的实际模型 ID。

5. 验证配置

完成上述配置后，可以通过运行 Hermes Agent 的测试命令验证配置是否生效：

hermes test --provider custom

如果配置正确，应该能看到来自 Taotoken 的模型响应。如果遇到问题，请检查以下几点：

• base_url是否正确包含/v1
• API Key 是否正确且未过期
• 模型 ID 是否存在于 Taotoken 模型广场
• 环境变量是否已正确加载

6. 使用 TaoToken CLI 快速配置（可选）

对于希望快速完成配置的用户，可以使用 TaoToken 官方提供的 CLI 工具：

npx @taotoken/taotoken hermes --key YOUR_API_KEY --model YOUR_MODEL_ID

该命令会自动完成上述配置步骤，将必要信息写入 Hermes Agent 的配置文件和.env中。

完成配置后，即可在 Hermes Agent 中使用 Taotoken 提供的各种模型能力。更多高级用法和配置选项可以参考 Hermes Agent 官方文档。