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

使用 Hermes Agent 框架并配置 Taotoken 作为自定义模型供应商

news 2026/5/14 21:46:01

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

使用 Hermes Agent 框架并配置 Taotoken 作为自定义模型供应商

Hermes Agent 是一个流行的开源框架，用于构建和运行基于大语言模型的智能体应用。如果你正在使用 Hermes Agent，并且希望通过 Taotoken 平台来统一接入和管理多个大模型，本文将为你提供一个清晰的配置指南。整个过程的核心是将 Taotoken 设置为 Hermes Agent 的custom供应商，并正确配置相关的连接参数。

1. 准备工作：获取 Taotoken 凭证与模型 ID

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

API Key：登录 Taotoken 控制台，在「API 密钥」页面创建一个新的密钥。请妥善保管此密钥。
模型 ID：在 Taotoken 的「模型广场」页面，浏览并选择你想要使用的模型，例如claude-sonnet-4-6或gpt-4o-mini。记下该模型的完整 ID。

这些信息将用于后续的配置步骤。

2. 理解 Hermes Agent 的供应商配置

Hermes Agent 支持多种模型供应商，如 OpenAI、Anthropic 等。当使用 Taotoken 时，我们需要选择custom供应商类型，因为 Taotoken 提供了与 OpenAI 兼容的 API 端点，但并非原厂服务。

关键配置点在于base_url。对于 Taotoken 的 OpenAI 兼容通道，其base_url必须包含/v1路径后缀。这是与直接使用 OpenAI 官方 SDK 或其他一些工具（如 Claude Code 的 Anthropic 通道）配置上的主要区别，请务必注意。

3. 通过 Taotoken CLI 快速配置（推荐）

Taotoken 提供了官方的命令行工具@taotoken/taotoken，可以简化与 Hermes Agent 等工具的集成配置。

首先，确保你的系统已安装 Node.js 环境。然后，你可以选择全局安装 CLI 工具，或者直接使用npx运行：

# 方式一：全局安装 npm install -g @taotoken/taotoken # 方式二：使用 npx（无需安装） npx @taotoken/taotoken hermes --help

配置 Hermes Agent 最快捷的方式是使用交互式菜单。在终端中运行taotoken命令，根据菜单提示选择 “Hermes Agent” 选项，然后依次输入你的 Taotoken API Key 和想要使用的模型 ID。CLI 工具会自动帮你生成或更新 Hermes Agent 所需的配置文件。

你也可以使用命令行参数进行快速配置：

taotoken hermes --key YOUR_TAOTOKEN_API_KEY --model YOUR_MODEL_ID

或者使用简写：

taotoken hm -k YOUR_TAOTOKEN_API_KEY -m YOUR_MODEL_ID

执行此命令后，工具会引导你完成配置，通常会将必要的base_url（格式为https://taotoken.net/api/v1）和 API Key 写入 Hermes Agent 框架预期的位置，例如项目根目录下的.env文件。

4. 手动配置 Hermes Agent 项目

如果你希望手动配置，或者需要理解配置的底层原理，可以按照以下步骤操作。

步骤一：设置环境变量Hermes Agent 通常通过环境变量来读取 API 配置。在你的项目根目录下，找到或创建.env文件，并添加以下内容：

# .env 文件 OPENAI_API_KEY=你的_Taotoken_API_Key OPENAI_BASE_URL=https://taotoken.net/api/v1

请注意，这里我们使用了OPENAI_API_KEY和OPENAI_BASE_URL这两个变量名，因为 Hermes Agent 的custom供应商配置会映射到这些标准的环境变量上。OPENAI_BASE_URL的值必须精确地设置为https://taotoken.net/api/v1。

步骤二：修改 Hermes Agent 配置文件接下来，需要修改 Hermes Agent 的主配置文件（通常是hermes.config.js或hermes.config.ts）。在配置模型的providers部分，添加一个custom供应商。

// hermes.config.js 示例 export default { // ... 其他配置 providers: { // 可以保留其他供应商配置 openai: { apiKey: process.env.OPENAI_API_KEY, }, // 添加 custom 供应商指向 Taotoken custom: { apiKey: process.env.OPENAI_API_KEY, // 读取上面设置的环境变量 baseURL: process.env.OPENAI_BASE_URL, // 关键：指向 Taotoken 的 /v1 端点 }, }, // 在 agents 配置中指定使用 custom 供应商 agents: { my_agent: { provider: 'custom', // 指定使用上面定义的 custom 供应商 model: 'claude-sonnet-4-6', // 使用你在 Taotoken 模型广场选择的模型 ID }, }, };

关键点：custom供应商下的baseURL属性必须设置为https://taotoken.net/api/v1。模型model字段应填写你在 Taotoken 模型广场看到的完整模型 ID。

5. 验证配置与运行

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

// test_agent.js import { Hermes } from 'hermes-agent'; // Hermes 会自动读取 hermes.config.js 和 .env 中的配置 const hermes = new Hermes(); const agent = hermes.getAgent('my_agent'); // 对应配置中的 agent 名称 async function test() { try { const response = await agent.run('Hello, world!'); console.log('Agent Response:', response); console.log('配置成功！Hermes Agent 已通过 Taotoken 连接到大模型。'); } catch (error) { console.error('连接失败，请检查配置:', error.message); console.error('请确认：1. API Key 是否正确且有效；2. baseURL 是否包含 /v1；3. 模型 ID 是否存在于 Taotoken 模型广场。'); } } test();

运行此脚本，如果看到模型返回的响应，则说明配置成功。如果遇到错误，请根据错误信息重点检查 API Key、baseURL的格式以及模型 ID 是否正确。

通过以上步骤，你就成功地将 Taotoken 配置为 Hermes Agent 的自定义模型供应商。之后，你可以在 Taotoken 控制台中统一管理 API 调用、查看用量和分析成本，而无需修改 Hermes Agent 的业务代码，只需在 Taotoken 侧切换模型或管理密钥即可。更多高级配置和细节，请参考 Hermes Agent 的官方文档和 Taotoken 的接入说明。