为Hermes Agent配置Taotoken作为自定义模型提供方
为Hermes Agent配置Taotoken作为自定义模型提供方
1. 准备工作
在开始配置前,请确保已安装Hermes Agent并获取Taotoken API Key。登录Taotoken控制台,在「API密钥管理」页面创建新的密钥。同时,在「模型广场」查看可用模型ID,例如claude-sonnet-4-6或gpt-4-turbo-preview。
Hermes Agent支持通过环境变量或配置文件设置自定义模型提供方。无论采用哪种方式,都需要正确指定三个关键参数:provider类型、base_url地址和API密钥。
2. 通过环境变量配置
对于临时测试或容器化部署场景,推荐使用环境变量配置。在终端中执行以下命令(以Linux/macOS为例):
export OPENAI_API_KEY="YOUR_TAOTOKEN_API_KEY" export HERMES_PROVIDER="custom" export HERMES_BASE_URL="https://taotoken.net/api/v1"重要注意事项:
HERMES_PROVIDER必须设置为custom,这是识别Taotoken为自定义提供方的关键HERMES_BASE_URL必须包含/v1路径,这是与OpenAI兼容API交互的必要条件- 密钥通过
OPENAI_API_KEY传递,与原生OpenAI SDK保持兼容
设置完成后,可以运行Hermes Agent测试连接:
hermes --model claude-sonnet-4-6 "你好"3. 通过配置文件设置
对于长期使用的开发环境,建议将配置写入Hermes Agent的配置文件。默认配置文件通常位于:
- Linux/macOS:
~/.hermes/config.json - Windows:
%APPDATA%\hermes\config.json
用文本编辑器打开配置文件,添加或修改以下字段:
{ "provider": "custom", "base_url": "https://taotoken.net/api/v1", "api_key": "YOUR_TAOTOKEN_API_KEY", "default_model": "claude-sonnet-4-6" }保存文件后,Hermes Agent会自动读取这些配置。可以通过以下命令验证配置是否生效:
hermes config show在输出中检查provider、base_url和api_key字段是否正确显示为Taotoken的配置。
4. 验证与测试
完成配置后,建议运行简单测试验证连接是否正常。创建一个测试文件test_prompt.txt,内容为:
你好,请用中文回答当前时间然后执行:
hermes --model claude-sonnet-4-6 -f test_prompt.txt如果配置正确,将返回模型的响应内容。若遇到错误,请检查:
- API Key是否有调用权限
base_url是否完整包含https://taotoken.net/api/v1- 模型ID是否在Taotoken平台可用
5. 进阶配置选项
对于团队协作场景,可以在项目根目录创建.env文件统一管理配置:
# .env OPENAI_API_KEY=YOUR_TAOTOKEN_API_KEY HERMES_PROVIDER=custom HERMES_BASE_URL=https://taotoken.net/api/v1 HERMES_DEFAULT_MODEL=claude-sonnet-4-6Hermes Agent会自动加载项目中的.env文件。这种方式既方便版本控制(可将.env加入.gitignore),又能保持开发环境一致性。
如需在代码中直接调用,可以参考以下Node.js示例:
const { Hermes } = require('hermes-agent'); const agent = new Hermes({ provider: 'custom', baseUrl: 'https://taotoken.net/api/v1', apiKey: process.env.OPENAI_API_KEY }); const response = await agent.chat('你好', { model: 'claude-sonnet-4-6' }); console.log(response);通过以上步骤,您已成功将Taotoken配置为Hermes Agent的自定义模型提供方。更多高级用法可以参考Hermes Agent官方文档。
