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

在Hermes Agent中配置自定义供应商指向Taotoken的详细流程

Hermes Agent 是一款功能强大的AI代理开发框架，支持通过自定义供应商接入不同的模型服务。对于使用 Taotoken 平台的开发者而言，将其配置为 Hermes Agent 的模型后端，可以便捷地在项目中调用平台聚合的多种大模型。本文将详细介绍这一配置流程。

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

在开始配置之前，你需要准备好来自 Taotoken 平台的两项关键信息。首先，登录 Taotoken 控制台，在 API 密钥管理页面创建一个新的密钥，请妥善保管这串字符，它将作为身份验证的凭证。其次，前往模型广场，浏览并选择你计划在 Hermes Agent 中使用的模型，记录下其对应的模型 ID，例如 claude-sonnet-4-6 或 gpt-4o-mini。这些信息是后续配置的基础。

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

Hermes Agent 支持多种供应商，包括 OpenAI、Anthropic 等官方服务商。当使用 Taotoken 这类提供 OpenAI 兼容 API 的平台时，我们需要选择 custom 供应商类型。其核心配置项是 base_url，它决定了请求发往的服务器地址。对于 Taotoken，此地址必须设置为 https://taotoken.net/api/v1。请特别注意，这里的路径末尾包含 /v1，这与直接使用 OpenAI 官方 SDK 的约定一致，但不同于某些工具（如 Claude Code）的 Anthropic 兼容端点配置，切勿混淆。

API 密钥的传递通常通过环境变量进行。Hermes Agent 在寻找自定义供应商的密钥时，默认会读取 OPENAI_API_KEY 这个环境变量。因此，我们需要将 Taotoken 的 API Key 设置到这个变量中。

3. 分步配置流程

你可以通过修改项目配置文件或环境变量文件来完成设置。以下是两种常见且清晰的方法。

方法一：通过项目配置文件设置 在 Hermes Agent 项目的配置文件（通常是 hermes.config.js 或 hermes.config.ts）中，找到或添加供应商配置部分。你需要将 provider 指定为 custom，并正确设置 base_url。

// hermes.config.js 示例片段
export default {
  // ... 其他配置
  providers: {
    custom: {
      baseURL: 'https://taotoken.net/api/v1', // 关键：确保地址正确
      // 其他自定义配置...
    },
  },
  // 默认使用自定义供应商
  defaultProvider: 'custom',
};

方法二：通过环境变量文件设置 更安全的做法是将敏感信息存放在环境变量中。在项目根目录下创建或编辑 .env 文件，添加以下两行：

OPENAI_API_KEY=你的_Taotoken_API_Key
HERMES_BASE_URL=https://taotoken.net/api/v1

随后，在你的 Hermes Agent 配置代码中，读取这些环境变量。

// 在配置中读取环境变量
import 'dotenv/config';

export default {
  providers: {
    custom: {
      baseURL: process.env.HERMES_BASE_URL,
      apiKey: process.env.OPENAI_API_KEY,
    },
  },
  defaultProvider: 'custom',
};

完成上述任一配置后，在代码中调用模型时，只需使用在 Taotoken 模型广场查看到的模型 ID 即可。

import { Hermes } from 'hermes-agent';

const hermes = new Hermes();
const response = await hermes.chat.completions.create({
  model: 'claude-sonnet-4-6', // 替换为你的目标模型ID
  messages: [{ role: 'user', content: '你好，请介绍一下你自己。' }],
});
console.log(response.choices[0].message.content);

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

为了简化配置过程，Taotoken 提供了一个官方的命令行工具 @taotoken/taotoken。你可以通过 npm 安装它。

npm install -g @taotoken/taotoken

安装后，运行 taotoken hermes 或简写 taotoken hm 命令，工具会启动一个交互式向导。你只需按照提示，依次输入之前在 Taotoken 控制台获取的 API Key 和选定的模型 ID。该 CLI 工具会自动帮你生成或更新 Hermes Agent 项目所需的配置文件和环境变量，确保 base_url 等参数正确无误。具体命令和写入的配置格式，可参考 Hermes Agent 接入说明。

5. 验证与后续步骤

配置完成后，建议运行一个简单的测试对话来验证连接是否成功。如果遇到超时或认证错误，请按顺序检查以下几点：API Key 是否正确无误且未过期；base_url 是否完整地写为 https://taotoken.net/api/v1；项目中的环境变量是否已正确加载；以及所选模型 ID 是否在 Taotoken 平台你的账户权限内可用。

成功对接后，你便可以在 Hermes Agent 项目中无缝使用 Taotoken 平台上的各类模型。所有调用将统一通过 Taotoken 进行计费和管理，你可以在 Taotoken 控制台的用量看板中清晰查看各模型的 token 消耗情况。

开始你的集成之旅吧，访问 Taotoken 创建密钥并探索可用模型。

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