🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度

在Hermes Agent项目中自定义Taotoken作为模型提供商

基础教程类，指导需要在Hermes Agent中使用自定义模型的开发者，如何根据文档设置provider与base_url参数，并将Taotoken的密钥写入约定的环境变量文件，完成接入配置。

Hermes Agent 是一个流行的开源AI代理框架，它允许开发者灵活地接入不同的模型服务。当你希望使用 Taotoken 平台聚合的模型时，可以通过其自定义提供商（Custom Provider）功能进行配置。本文将分步说明如何将 Taotoken 设置为 Hermes Agent 的模型提供商。

1. 准备工作：获取必要的凭证

在开始配置之前，你需要准备好以下两项信息：

1. Taotoken API Key：登录 Taotoken 控制台，在「API 密钥」页面创建一个新的密钥。请妥善保管此密钥。
2. 模型 ID：访问 Taotoken 的「模型广场」，浏览并选择你希望使用的模型，例如 claude-sonnet-4-6 或 gpt-4o-mini。记录下该模型的唯一标识符。

2. 配置 Hermes Agent 使用 Taotoken

Hermes Agent 通过配置文件或环境变量来管理模型提供商。使用 Taotoken 时，核心是将其配置为一个自定义的 OpenAI 兼容端点。

2.1 通过环境变量配置（推荐）

最直接的方式是通过环境变量进行配置。Hermes Agent 会读取项目根目录下的 .env 文件。

1. 在你的 Hermes Agent 项目根目录下，找到或创建一个名为 .env 的文件。
2. 在该文件中添加或修改以下行：

# 指定使用自定义提供商
PROVIDER=custom
# 设置 Taotoken 的 OpenAI 兼容 API 地址
BASE_URL=https://taotoken.net/api/v1
# 填入你在 Taotoken 控制台获取的 API Key
OPENAI_API_KEY=sk-your-taotoken-api-key-here
# 指定你想使用的模型，例如 claude-sonnet-4-6
MODEL=claude-sonnet-4-6

关键点说明：

• PROVIDER=custom：这告诉 Hermes Agent 使用自定义的端点配置。
• BASE_URL：必须设置为 https://taotoken.net/api/v1。请注意，此地址末尾包含 /v1，这是 OpenAI 兼容 API 的标准路径格式，与 Claude Code 等工具的 Anthropic 兼容地址不同。
• OPENAI_API_KEY：此处应填入你的 Taotoken API Key。Hermes Agent 会使用此变量名来读取密钥。
• MODEL：此处填入你在 Taotoken 模型广场选定的模型 ID。

2.2 在代码中动态配置

如果你倾向于在代码中直接配置，可以在初始化 Hermes Agent 客户端时传入参数。以下是一个示例：

// 示例为 JavaScript/Node.js 环境
import { Hermes } from 'hermes-agent';

const agent = new Hermes({
  provider: 'custom',
  config: {
    baseURL: 'https://taotoken.net/api/v1', // 注意 baseURL 参数名
    apiKey: process.env.TAOTOKEN_API_KEY || 'sk-your-key', // 建议从环境变量读取
    defaultModel: 'claude-sonnet-4-6',
  },
});

// 后续使用 agent 进行对话等操作

请注意，代码中的 baseURL 参数同样需要指向带 /v1 的完整路径。

3. 验证配置与测试

完成配置后，你可以运行一个简单的测试来验证连接是否成功。

1. 确保你的 .env 文件已正确保存，并且环境变量已被加载（例如，在终端中通过 source .env 或在支持 .env 的运行时环境中启动应用）。
2. 编写或运行一段简单的测试代码，让 Hermes Agent 发送一个基础的对话请求。
3. 观察返回结果。如果配置正确，你将收到来自所选模型的正常回复。如果出现认证错误，请检查 API Key 是否正确；如果出现连接或端点错误，请确认 BASE_URL 是否准确设置为 https://taotoken.net/api/v1。

4. 使用 TaoToken CLI 工具快速配置（可选）

为了简化配置流程，Taotoken 提供了一个官方的 CLI 工具 @taotoken/taotoken。你可以使用它来快速生成 Hermes Agent 的配置。

1. 安装 CLI 工具（非必须全局安装）：

   npx @taotoken/taotoken
   

2. 运行工具并跟随交互式菜单选择 Hermes Agent 配置选项。
3. 根据提示输入你的 Taotoken API Key 和模型 ID。
4. 工具会指导你完成配置，或直接生成相应的配置片段。

此 CLI 工具的具体命令和输出可能更新，建议查阅其官方文档或仓库以获取最新信息。

通过以上步骤，你即可成功将 Taotoken 配置为 Hermes Agent 的自定义模型提供商，从而在项目中便捷地调用 Taotoken 平台上的多种大模型。具体的模型能力、计费详情和用量统计，请以 Taotoken 控制台和官方文档为准。

🚀 告别海外账号与网络限制！稳定直连全球优质大模型，限时半价接入中。 👉 点击领取海量免费额度