Hermes Agent 自定义供应商配置接入 Taotoken 的详细流程
1. 准备工作
在开始配置之前,请确保您已经完成以下准备工作:拥有有效的 Taotoken API Key,可以在 Taotoken 控制台中创建和管理;了解 Hermes Agent 的基本使用方法,并已安装最新版本的 Hermes Agent。
您需要在 Taotoken 模型广场查看可用的模型 ID,这些 ID 将用于后续的配置。常见的模型 ID 格式如claude-sonnet-4-6或gpt-4-turbo等,具体以模型广场展示为准。
2. 配置 Hermes Agent 使用 Taotoken
Hermes Agent 支持通过配置文件或环境变量来设置自定义供应商。以下是两种配置方式的详细说明。
2.1 通过配置文件设置
Hermes Agent 的主配置文件通常位于~/.hermes/config.json(Linux/macOS)或%USERPROFILE%\.hermes\config.json(Windows)。您需要编辑此文件,添加 Taotoken 的相关配置。
{ "providers": { "custom": { "base_url": "https://taotoken.net/api/v1", "api_key": "YOUR_TAOTOKEN_API_KEY" } }, "defaults": { "provider": "custom", "model": "claude-sonnet-4-6" } }重要注意事项:
base_url必须包含/v1后缀,这是与 OpenAI 兼容 API 的必要路径api_key应替换为您在 Taotoken 控制台获取的真实 API Keymodel应设置为 Taotoken 模型广场中提供的有效模型 ID
2.2 通过环境变量设置
如果您更倾向于使用环境变量,可以在启动 Hermes Agent 前设置以下变量:
export HERMES_PROVIDER=custom export HERMES_BASE_URL=https://taotoken.net/api/v1 export HERMES_API_KEY=YOUR_TAOTOKEN_API_KEY export HERMES_DEFAULT_MODEL=claude-sonnet-4-6Windows 用户可以使用set命令代替export:
set HERMES_PROVIDER=custom set HERMES_BASE_URL=https://taotoken.net/api/v1 set HERMES_API_KEY=YOUR_TAOTOKEN_API_KEY set HERMES_DEFAULT_MODEL=claude-sonnet-4-63. 验证配置
配置完成后,您可以通过以下命令验证 Hermes Agent 是否成功连接到 Taotoken:
hermes chat "请回复'测试成功'如果配置正确"如果配置正确,您应该会收到包含"测试成功"的响应。如果遇到错误,请检查以下常见问题:
base_url是否正确包含/v1后缀- API Key 是否正确且未过期
- 模型 ID 是否在 Taotoken 模型广场中可用
- 网络连接是否正常,能够访问
https://taotoken.net
4. 使用 TaoToken CLI 快速配置(可选)
如果您希望更快速地完成配置,可以使用 TaoToken 官方提供的 CLI 工具:
npm install -g @taotoken/taotoken taotoken hermes --key YOUR_API_KEY --model YOUR_MODEL_ID此命令会自动为您生成正确的 Hermes Agent 配置文件,无需手动编辑。CLI 工具会确保所有路径和参数设置正确,包括自动添加必要的/v1后缀到base_url。
5. 进阶使用
成功配置后,您可以在 Hermes Agent 中充分利用 Taotoken 的多模型能力:
临时切换模型:在聊天命令中指定不同的模型 ID
hermes chat --model gpt-4-turbo "请用GPT-4回答这个问题"查看使用情况:Taotoken 控制台提供了详细的用量统计和计费信息
团队协作:可以在 Hermes Agent 配置中设置多个 API Key,便于团队不同成员使用
如需了解更多 Hermes Agent 的高级功能,可以参考其官方文档。Taotoken 的模型广场会定期更新可用模型,建议定期查看以获取最新信息。
Taotoken