为 Ubuntu 上的开源 Agent 工具 Hermes 配置 Taotoken 自定义提供商

1. 准备工作

在开始配置之前，请确保您的 Ubuntu 系统已安装以下组件：

• Node.js 16 或更高版本
• npm 或 yarn 包管理器
• Hermes Agent 已正确安装并初始化

您还需要准备好以下信息：

• 有效的 Taotoken API Key（可在 Taotoken 控制台创建）
• 目标模型 ID（可在 Taotoken 模型广场查看）

2. 安装 Taotoken CLI 工具

Taotoken 提供了官方 CLI 工具来简化配置过程。在终端中执行以下命令安装：

npm install -g @taotoken/taotoken

如果您不希望全局安装，也可以使用 npx 直接运行：

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

3. 手动配置 Hermes Agent

如果您更倾向于手动配置，请按照以下步骤操作：

3.1 设置环境变量

Hermes Agent 通常会从 .env 文件中读取配置。在您的项目根目录下创建或编辑 .env 文件，添加以下内容：

OPENAI_API_KEY=your_taotoken_api_key
OPENAI_BASE_URL=https://taotoken.net/api/v1

重要提示：OPENAI_BASE_URL 必须包含 /v1 路径，这是与 OpenAI 兼容 API 的关键区别。

3.2 修改 Hermes 配置文件

在 Hermes 的配置文件中（通常是 hermes.config.js 或 config/default.json），确保 provider 设置为 custom：

{
  "provider": "custom",
  "apiKey": process.env.OPENAI_API_KEY,
  "baseUrl": process.env.OPENAI_BASE_URL,
  "model": "taotoken/claude-sonnet-4-6" // 替换为您需要的模型ID
}

4. 验证配置

配置完成后，可以通过以下方式验证是否成功：

hermes --test

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

• API Key 是否正确且未过期
• Base URL 是否包含 /v1
• 网络连接是否正常

5. 使用 Hermes 与 Taotoken 交互

配置成功后，您可以像平常一样使用 Hermes 命令与 Taotoken 提供的模型交互：

hermes "你的问题或指令"

所有请求将通过 Taotoken 平台路由到您指定的模型，并在控制台中记录使用量和费用。

6. 进阶配置（可选）

如果您需要更精细的控制，可以在 Hermes 配置中指定更多参数：

{
  "provider": "custom",
  "apiKey": process.env.OPENAI_API_KEY,
  "baseUrl": process.env.OPENAI_BASE_URL,
  "model": "taotoken/claude-sonnet-4-6",
  "temperature": 0.7,
  "maxTokens": 1000
}

这些参数将随每个请求发送到 Taotoken API。

---

现在您已经成功将 Hermes Agent 配置为使用 Taotoken 作为自定义提供商。如需了解更多功能或查看最新支持的模型，请访问 Taotoken。