如何为 Hermes Agent 工具配置 Taotoken 作为自定义模型提供商
1. 准备工作
在开始配置前,请确保已安装 Hermes Agent 并完成基础环境搭建。您需要准备以下信息:
- 有效的 Taotoken API Key(可在控制台「API 密钥」页面生成)
- 目标模型 ID(可在模型广场查看,如
claude-sonnet-4-6) - Hermes Agent 项目配置文件(通常为
hermes.config.js或.env)
2. 配置 Taotoken 作为自定义提供商
Hermes Agent 支持通过custom提供商类型接入第三方模型平台。以下是关键配置步骤:
2.1 修改配置文件
在 Hermes 项目配置文件中指定 Taotoken 的接入参数。以常见场景为例:
// hermes.config.js module.exports = { providers: { default: 'custom', custom: { baseUrl: 'https://taotoken.net/api/v1', // 注意必须包含 /v1 apiKey: process.env.TAOTOKEN_API_KEY // 从环境变量读取 } }, models: { default: 'taotoken/claude-sonnet-4-6' // 格式为 taotoken/<模型ID> } }2.2 设置环境变量
在项目根目录的.env文件中添加密钥(该文件应加入.gitignore):
# .env TAOTOKEN_API_KEY=your_api_key_here3. 使用 TaoToken CLI 快速配置(可选)
若已安装@taotoken/taotokenCLI 工具,可通过以下命令快速完成配置:
taotoken hermes --key YOUR_API_KEY --model claude-sonnet-4-6该命令会自动:
- 在
.env写入TAOTOKEN_API_KEY - 生成包含正确
baseUrl的 Hermes 配置文件 - 设置默认模型为指定 ID
4. 验证配置
通过简单测试请求验证配置是否生效:
// test.js const hermes = require('hermes-agent'); async function test() { const response = await hermes.chat({ messages: [{ role: 'user', content: 'Hello' }] }); console.log(response); } test();预期应返回模型生成的响应内容。若遇到 401 错误请检查 API Key,404 错误请确认baseUrl是否包含/v1。
5. 注意事项
- 路径差异:Hermes 使用 OpenAI 兼容协议,必须确保
baseUrl以/v1结尾,这与 Claude Code 等 Anthropic 协议工具不同 - 模型前缀:在 Hermes 中调用时,模型 ID 需要添加
taotoken/前缀(如taotoken/claude-sonnet-4-6) - 密钥安全:建议通过环境变量管理 API Key,不要直接硬编码在配置文件中
如需进一步了解 Hermes Agent 与 Taotoken 的集成细节,可查阅 Hermes Agent 接入说明。
Taotoken 提供多模型统一接入与管理能力,开发者可通过兼容 API 快速集成主流模型服务。