Hermes Agent 接入指南

通过 OpenAI 兼容接口在 Hermes Agent 中接入 TokenPlus，配置模型并开始对话。

本文介绍如何在 Hermes Agent 中配置 TokenPlus 自定义端点，通过 OpenAI Chat Completions 接口调用模型。

第一步：准备 Hermes Agent 和 TokenPlus API

开始前，请按照 Hermes Agent 官方文档完成安装，并按照 TokenPlus 快速入门完成注册、实名认证、充值和 API 密钥创建。

接入时需要以下信息：

配置项	填写内容
提供商	`Custom endpoint`（自定义端点）
Base URL	`https://api.tokenplus.cn/v1`
API 密钥	在 TokenPlus 项目空间创建的完整密钥
模型 ID	从 TokenPlus 模型广场复制的完整模型调用标识

请选择已开通、支持 OpenAI Chat Completions 和工具调用的模型。模型 ID 不一定等于展示名称，请保留平台提供的完整标识及前缀。

Base URL 必须包含 /v1，不要在末尾再添加 /chat/completions；Hermes 会自动拼接请求路径。这里使用 TokenPlus API 密钥，不是 OpenAI 或 Nous 的密钥。

在终端运行：

hermes model

在提供商列表中选择 Custom endpoint，部分版本显示为 Custom endpoint (self-hosted / VLLM / etc.)。
将 API Base URL 填写为 https://api.tokenplus.cn/v1。
输入 TokenPlus API 密钥。
选择或手动输入从 TokenPlus 复制的完整模型 ID。
按提示完成配置；如果出现推理强度选项，请按所选模型支持的能力选择。

配置完成后，Hermes 会保存端点和默认模型。API 密钥不要提交到代码仓库，也不要放入截图或分享给他人。

如果需要通过配置文件接入，可以在默认配置目录的 ~/.hermes/.env 中新增：

TOKENPLUS_API_KEY=YOUR_TOKENPLUS_API_KEY

将 YOUR_TOKENPLUS_API_KEY 替换为实际密钥，并保留文件中的其他变量。

备份 ~/.hermes/config.yaml，将以下字段合并到现有 model 配置中：

model:
  provider: custom
  default: YOUR_MODEL_ID
  base_url: https://api.tokenplus.cn/v1
  key_env: TOKENPLUS_API_KEY

将 YOUR_MODEL_ID 替换为实际模型 ID。若 model 目前是空字符串，请将这一项替换为上面的结构；不要覆盖整个配置文件。若原有 model.api_key 指向其他平台，请移除该旧字段，使用 key_env 引用 TokenPlus 密钥。

使用自定义配置目录或 profile 时，请编辑对应配置目录中的文件。不要只设置 OPENAI_BASE_URL 来配置 custom 提供商；请通过向导或 model.base_url 指定端点。手动修改后，请重新启动 Hermes；已运行的相关服务也需重新加载配置。

在终端检查当前配置：

hermes config get model
hermes status

确认 Base URL 和默认模型与 TokenPlus 提供的信息一致，然后启动新会话：

hermes

输入一条测试消息：

你好，请用一句话介绍你能帮我做什么。

收到正常回复后，可以进入 TokenPlus 的调用日志，核对请求状态、模型和费用。普通对话成功后，再测试需要的工具调用任务。

如需更改默认模型，退出当前会话后重新运行 hermes model。

在已配置自定义端点的会话中，也可以使用以下命令切换模型，将占位符替换为实际模型 ID：

/model custom:YOUR_MODEL_ID

这里的 custom: 是 Hermes 的提供商选择语法，不是 TokenPlus API 模型 ID 的一部分。

如果使用仪表板，可以在 Models → Model Settings 中点击主模型行的 Change，选择已配置的提供商和模型后点击 Switch。仪表板修改默认模型仅对新会话生效，已有会话请使用 /model 切换。