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

为 Hermes Agent 配置 Custom 供应商并指向 Taotoken 服务

本教程将指导 Hermes Agent 用户，如何将其配置为使用 Taotoken 作为自定义模型供应商。通过完成 provider 设置、Base URL 与环境变量的配置，您即可在 Hermes Agent 中便捷地调用 Taotoken 平台聚合的各类大模型。

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

在开始配置之前，您需要从 Taotoken 平台获取两个关键信息：API Key 和模型 ID。

首先，请访问 Taotoken 控制台，创建一个新的 API Key。创建时，您可以根据需要设置其名称、权限和额度。创建成功后，请妥善保存此 Key。

其次，您需要确定要使用的具体模型。请前往 Taotoken 的“模型广场”页面，浏览并选择您需要的模型，例如 claude-sonnet-4-6 或 gpt-4o。记录下该模型的完整 ID，后续配置将用到它。

2. 配置 Hermes Agent 的 Provider

Hermes Agent 支持通过 custom 供应商类型来接入第三方兼容服务。要使用 Taotoken，您需要将其配置为一个自定义供应商。

请找到 Hermes Agent 的配置文件。根据您的安装方式，配置文件通常位于项目根目录下的 hermes.config.json 或 config.json 中。您需要在 providers 配置段内，添加一个 custom 类型的供应商。

一个典型的配置示例如下：

{
  "providers": {
    "custom": {
      "taotoken": {
        "base_url": "https://taotoken.net/api/v1",
        "api_key": "${TAOTOKEN_API_KEY}",
        "models": ["taotoken/claude-sonnet-4-6"]
      }
    }
  }
}

请注意几个关键点：

1. provider 类型必须设置为 custom。
2. base_url 字段的值必须是 https://taotoken.net/api/v1。这里的 /v1 后缀是必需的，这与 OpenAI 兼容的 API 路径约定保持一致。
3. api_key 字段建议通过环境变量 ${TAOTOKEN_API_KEY} 引用，而非直接硬编码在配置文件中，以提高安全性。
4. models 字段用于声明此供应商支持的模型列表。模型名称建议以 taotoken/ 为前缀，后接您在模型广场选择的实际模型 ID，这有助于在 Hermes 内部清晰区分模型来源。

3. 设置环境变量

如上一步所述，我们将 API Key 通过环境变量注入，以避免敏感信息泄露。通常，Hermes Agent 会从项目根目录下的 .env 文件中读取环境变量。

请创建或编辑 .env 文件，添加如下内容：

TAOTOKEN_API_KEY=your_actual_taotoken_api_key_here

请将 your_actual_taotoken_api_key_here 替换为您在第一步中获取的真实 API Key。保存文件后，请确保您的开发环境或运行环境能够正确加载此 .env 文件中的变量。

4. 在 Hermes 中使用 Taotoken 模型

完成上述配置后，您就可以在 Hermes Agent 的会话或工作流中指定使用 Taotoken 的模型了。

当您需要通过命令行启动一个会话时，可以使用 --model 参数来指定模型：

hermes chat --model taotoken/claude-sonnet-4-6

如果您是在代码中初始化 Hermes 客户端，则可以在创建客户端时指定模型参数。具体的代码调用方式，请参考 Hermes Agent 的官方 SDK 文档。

此时，Hermes Agent 发出的请求将会通过您配置的 base_url 发送至 Taotoken 平台，并使用对应的 API Key 进行鉴权，最终由您指定的模型返回结果。

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

为了简化配置流程，Taotoken 提供了一个官方的 CLI 工具 @taotoken/taotoken。您可以使用它来交互式地完成对 Hermes Agent 的配置。

首先，您可以通过 npm 安装此工具：

npm install -g @taotoken/taotoken

安装完成后，在终端中运行 taotoken 命令，您将看到一个交互式菜单。选择与 Hermes Agent 相关的选项，然后按照提示输入您的 Taotoken API Key 和想要使用的模型 ID。该工具会自动帮您生成或更新 Hermes 的配置文件及环境变量文件。

您也可以使用一行命令快速完成配置：

taotoken hermes --key YOUR_API_KEY --model YOUR_MODEL_ID

此命令会执行与交互菜单相同的配置操作。关于 CLI 工具的更多子命令和选项细节，您可以查阅其官方文档。

---

完成以上步骤后，您就成功地将 Hermes Agent 对接到了 Taotoken 平台。现在，您可以在 Hermes 的统一界面中，灵活选用 Taotoken 所聚合的多种大模型，并享受统一的密钥管理与用量观测体验。如需了解更多高级功能或查看最新的模型列表，请访问 Taotoken 平台。

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