当前位置：首页 > news >正文

Hermes Agent 用户配置 Taotoken 作为自定义模型提供方的详细步骤

news 2026/5/27 12:31:51

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

Hermes Agent 用户配置 Taotoken 作为自定义模型提供方的详细步骤

对于使用 Hermes Agent 进行智能体开发的用户而言，能够灵活接入不同的模型服务是提升开发效率的关键。Taotoken 平台提供了与 OpenAI 兼容的 HTTP API，可以方便地作为 Hermes Agent 的自定义模型源。本文将详细介绍如何将 Taotoken 正确配置到 Hermes Agent 中，确保您能快速开始调用。

1. 准备工作：获取 Taotoken 的接入凭证

在开始配置之前，您需要在 Taotoken 平台完成两项准备工作。

首先，登录 Taotoken 控制台，在「API 密钥」页面创建一个新的 API Key。请妥善保存此密钥，它将在后续步骤中作为身份验证的凭证。

其次，前往「模型广场」页面，浏览并选择您希望使用的模型。每个模型都有一个唯一的模型 ID（例如claude-sonnet-4-6或gpt-4o）。请记录下您选定模型的 ID，配置 Hermes Agent 时需要指定它。

完成以上两步，您就拥有了接入所需的核心信息：API Key 和模型 ID。

2. 理解 Hermes Agent 的自定义提供方配置

Hermes Agent 支持通过custom类型的提供方来接入第三方兼容 API 服务。配置的核心在于正确指定两个关键参数：provider类型和base_url地址。

当选择 Taotoken 时，provider必须设置为custom。而base_url则需要指向 Taotoken 的 OpenAI 兼容 API 端点。这里有一个至关重要的细节：Taotoken 的 OpenAI 兼容端点 Base URL 需要包含/v1路径。这与直接使用某些原生 SDK 的配置略有不同，请务必注意。

因此，完整的base_url应设置为：https://taotoken.net/api/v1。这个地址是 Hermes Agent 与 Taotoken 服务通信的基础。

3. 配置 Hermes Agent 使用 Taotoken

配置 Hermes Agent 主要有两种方式：通过 TaoToken 官方 CLI 工具快速配置，或手动编辑配置文件。您可以根据习惯选择其一。

3.1 使用 TaoToken CLI 工具快速配置（推荐）

TaoToken 提供了一个命令行工具@taotoken/taotoken来简化多种工具的接入流程。对于 Hermes Agent，您可以按以下步骤操作：

安装 CLI 工具。您可以选择全局安装或直接使用 npx：
```
npm install -g @taotoken/taotoken # 或 npx @taotoken/taotoken
```
运行工具并选择 Hermes Agent 配置。您可以直接使用hermes（或简写hm）子命令，并传入您的 API Key 和模型 ID：
```
taotoken hermes --key YOUR_TAOTOKEN_API_KEY --model YOUR_MODEL_ID
```
该命令会自动完成后续的配置工作，包括在 Hermes Agent 的配置文件中正确写入provider: custom和base_url: https://taotoken.net/api/v1等参数。

3.2 手动编辑配置文件

如果您希望更精细地控制配置，或了解配置原理，可以手动操作。Hermes Agent 的配置通常涉及项目配置文件（如hermes.config.js或hermes.config.ts）和环境变量文件。

首先，在您的 Hermes Agent 项目配置文件中，找到模型提供方（provider）相关的配置部分。将其设置为使用custom提供方，并指定 Taotoken 的 Base URL。

一个简化的配置示例如下（具体结构请以您项目的实际配置文件为准）：

// hermes.config.js 示例片段 export default { // ... 其他配置 llm: { provider: 'custom', config: { baseURL: 'https://taotoken.net/api/v1', // 其他自定义配置... } } }

其次，需要安全地配置 API Key。通常，Hermes Agent 会从环境变量中读取密钥。请将您在第一步获取的 Taotoken API Key，设置到项目根目录下的.env文件中：

# .env 文件 OPENAI_API_KEY=您的_Taotoken_API_Key

请注意，虽然变量名是OPENAI_API_KEY，但其值应替换为您在 Taotoken 平台生成的密钥。这是因为 Hermes Agent 遵循 OpenAI 兼容的客户端约定，使用此环境变量名来获取认证令牌。

4. 验证配置与开始使用

完成配置后，建议进行一个简单的测试来验证连接是否成功。您可以在 Hermes Agent 项目中创建一个简单的测试脚本，尝试发起一次对话请求。

例如，在您的智能体代码中，使用配置好的 LLM 客户端调用一次简单的对话：

// 示例测试代码，取决于您的具体项目结构 const response = await agent.llm.chat.completions.create({ model: 'YOUR_MODEL_ID', // 使用您在模型广场选择的模型 ID messages: [{ role: 'user', content: 'Hello, Taotoken!' }], }); console.log(response.choices[0].message.content);

如果能够成功收到模型回复，则说明 Taotoken 自定义提供方配置成功。

在后续使用中，您可以通过 Taotoken 控制台的「用量统计」页面，实时查看调用详情和费用消耗，方便进行成本管理。如需切换模型，只需在 Hermes Agent 的配置或调用代码中，将model参数更换为 Taotoken 模型广场上其他模型的 ID 即可。

希望这份指南能帮助您顺利完成 Hermes Agent 与 Taotoken 的集成。如果您在配置过程中遇到任何问题，或想了解更多模型选项，可以访问 Taotoken 平台查看官方文档和最新信息。