在 Hermes Agent 项目中配置 custom provider 指向 Taotoken
1. 准备工作
在开始配置前,请确保已安装 Hermes Agent 框架并初始化项目。同时需要准备好 Taotoken 的 API Key,可在 Taotoken 控制台的 API Key 管理页面创建。模型 ID 可在模型广场查看,选择适合当前项目的模型。
2. 配置 custom provider
Hermes Agent 支持通过 custom provider 接入第三方模型服务。要使用 Taotoken 作为模型供应商,需要在配置文件中指定 provider 类型为 custom,并正确设置 base_url。
打开项目中的配置文件(通常为config.yml或hermes.config.js),找到 provider 相关配置项,修改为以下内容:
provider: type: custom base_url: https://taotoken.net/api/v1注意 base_url 必须包含/v1后缀,这是与 OpenAI 兼容 API 的路径约定。如果遗漏/v1,请求将无法正确路由。
3. 设置 API Key
Hermes Agent 通常从环境变量读取 API Key。在项目根目录下的.env文件中添加:
OPENAI_API_KEY=你的Taotoken_API_KEY如果项目使用其他环境变量名存储 API Key,请相应调整。确保该文件已添加到.gitignore中,避免密钥泄露。
4. 指定模型
在发起请求时,需要在请求参数中指定模型 ID。模型 ID 格式通常为taotoken/<模型名称>,例如:
const response = await hermes.createChatCompletion({ model: 'taotoken/claude-sonnet-4-6', messages: [{ role: 'user', content: 'Hello' }] });也可以在配置文件中设置默认模型,避免每次请求都需指定:
models: default: taotoken/claude-sonnet-4-65. 验证配置
完成上述配置后,可以通过简单的测试请求验证是否正常工作:
const testMessage = await hermes.createChatCompletion({ model: 'taotoken/claude-sonnet-4-6', messages: [{ role: 'user', content: '测试消息' }] }); console.log(testMessage.choices[0].message.content);如果收到模型响应,说明配置成功。若遇到问题,可检查以下几点:
- base_url 是否包含
/v1 - API Key 是否正确且未过期
- 模型 ID 是否存在拼写错误
- 网络连接是否正常
6. 使用 TaoToken CLI 快速配置(可选)
对于习惯使用命令行工具的用户,可以安装 TaoToken CLI 快速完成配置:
npm install -g @taotoken/taotoken taotoken hermes --key YOUR_API_KEY --model YOUR_MODEL_IDCLI 会自动写入正确的 base_url 和模型配置,简化设置过程。更多细节可参考 Hermes Agent 接入说明。
如需了解更多 Taotoken 的功能与模型选择,请访问 Taotoken。