Hermes

将 Token Factory 添加到 Hermes Agent 的自定义模型端点，为通用智能体配置国产模型服务。使用内置向导即可完成地址、凭据与模型设置。

开始前准备

1. 按Hermes 官方入门指南安装并完成基础设置。
2. 在控制台创建工具专用 API Key，确认通用余额充足。
3. 从模型文档复制已开放 OpenAI Chat Completions 的模型 ID；智能体任务需要模型支持工具调用与流式输出。

添加 Custom endpoint

在终端中运行模型设置向导：

hermes model

选择 Custom endpoint，按提示填写：

字段	填写内容
Base URL	https://api.tokenfactory.cn/v1
API Key	Token Factory 控制台创建的 API Key
Model	模型详情中的原始模型 ID
接口	OpenAI Chat Completions

Custom endpoint Base URL

Hermes 追加 /chat/completions 后，最终请求为 https://api.tokenfactory.cn/v1/chat/completions。不要省略 Base URL 中的 /v1，也不要把完整请求地址填入端点字段。

配置文件对应关系

向导会将模型与端点保存到 ~/.hermes/config.yaml。官方单个自定义端点的配置结构如下；<model-id> 与 <your-api-key> 均需替换：

model:
  default: "<model-id>"
  provider: custom
  base_url: "https://api.tokenfactory.cn/v1"
  api_key: "<your-api-key>"

已经通过向导保存时无需再次复制。手动编辑时合并现有 model 配置，保护本机文件权限，避免把凭据提交到项目或带入截图。

若使用 CC Switch管理多个自定义提供方，配置可能保存在 custom_providers 中；应在 CC Switch 中选择对应提供方，不要再用上面的单端点示例覆盖整个文件。

选择模型并验证

1. 完成向导后运行 hermes，开启新会话。
2. 确认当前端点与模型，发送：“只回复‘连接成功’，不读取文件、不执行命令。”
3. 得到正常回复后，再对一个测试文件发起读取或解释任务，检查工具调用和回复是否完整。

已有自定义端点时，可以在聊天中用 /model 切换模型。使用本文的 custom 提供方时，可输入：

/model custom:<model-id>

添加新端点、修改 API Key 应先退出会话，再运行终端命令 hermes model；聊天中的 /model 用于切换已配置的模型。模型调用使用通用余额按实际用量计费。

常见问题

现象	检查方法
/model 没有添加端点的入口	退出聊天，在终端执行 hermes model，选择 Custom endpoint 完成设置。
设置了 OPENAI_BASE_URL 仍未生效	自定义端点使用向导或 model.base_url；OPENAI_BASE_URL 属于 Hermes 的 openai-api 提供方配置。
401 认证失败	重新进入向导核对该端点的 Key，确认没有前后空格，且没有选中其他已保存提供方。
404	核对 Base URL 为 https://api.tokenfactory.cn/v1，最终路径不重复。
模型不存在或接口能力不可用	复制平台原始模型 ID，并确认已开放 Chat Completions。
能聊天但任务工具不可用	核对模型的工具调用能力，再检查 Hermes 工具配置与权限。
限流、余额不足或长任务中断	按错误处理排查；已执行部分操作时，先检查结果再继续。

相关文档

• Hermes 官方模型提供方与自定义端点
• Hermes 官方入门指南
• 使用 CC Switch 管理配置

验证范围：配置字段已按官方文档核对；Token Factory 的完整客户端调用仍待复验。