Hermes Agent 集成图灵平台指南

Hermes Agent 是由 Nous Research 开源的自主 AI 智能体，具备跨会话持久记忆、自学习技能系统、40+ 内置工具，支持多平台消息（Telegram / Discord / Slack / WhatsApp），并可通过 ACP 协议接入 VS Code、Zed、JetBrains 等 IDE。Hermes Agent 兼容任意 OpenAI 风格的 API 端点，因此可以直接对接图灵平台。

接入方式

本文档使用 Hermes 官方模型向导中的 "Custom endpoint (enter URL manually)" 方式，手动填写图灵平台的 API 地址与 API Key，无需自建路由层。

前置要求

在开始之前，请确保：

• 已获得图灵平台的 API 密钥（获取方式）
• 系统为 macOS / Linux / WSL2（官方安装脚本暂不支持原生 Windows，Windows 用户请使用 WSL2）
• 已安装 curl 与 bash（macOS / Linux 通常已自带）

快速开始

1. 安装 Hermes Agent

macOS / Linux / WSL2

推荐使用官方一键安装脚本，脚本会自动安装 uv、Python 3.11 并克隆项目：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后，重新加载 shell 配置：

# macOS 默认 zsh
source ~/.zshrc

# Linux 默认 bash
source ~/.bashrc

Windows (WSL2)

原生 Windows 为实验性支持，官方推荐在 WSL2 中安装。

1. 打开 WSL2 终端（如 Ubuntu）
2. 执行与 macOS / Linux 相同的安装命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc

安装完成后验证：

hermes --version

2. 运行模型配置向导

在终端中执行以下命令，启动模型 / 提供商配置向导：

hermes model

hermes model vs /model

• hermes model（终端中运行）：完整的 Provider 配置向导，可以新增自定义 Provider、输入 API Key、配置端点。
• /model（Hermes 会话中输入）：只能在已配置的 Provider 之间切换，不能新增 Provider。

首次接入图灵平台请务必使用 hermes model。

3. 选择 Custom endpoint 并填入图灵平台参数

在 hermes model 向导中，按提示完成以下配置：

向导提示	填写内容	说明
Select provider	Custom endpoint (enter URL manually)	选择自定义端点
API base URL	https://live-turing.cn.llm.tcljd.com/api/v1	图灵平台 OpenAI 兼容地址，末尾必须包含 /v1
API key	你的图灵平台 API Key	从图灵平台 Portal 获取
Model name	minimax-m2.7	填写模型列表中的 Model ID；可先用示例模型验证
Context length	128000（或留空自动检测）	建议按所选模型的上下文窗口填写，详见模型与价格

API 地址注意事项

• 图灵平台使用的是 OpenAI 兼容接口，路径结尾 必须是 /v1。
• 如果填成 https://live-turing.cn.llm.tcljd.com/api（缺失 /v1），会收到 404 或 invalid path 错误。
• 这与 Claude Code 所用的 Anthropic 原生端点不同，请勿混用。

向导结束后会把配置持久化到 ~/.hermes/config.yaml，下次直接运行 hermes 即可进入会话。

手动编辑配置文件

如果你更习惯手动编辑 YAML，可以直接修改 ~/.hermes/config.yaml，或执行：

hermes config edit

将 model 部分替换为以下内容（记得把 YOUR_TURING_API_KEY 换成你的真实密钥）：

model:
  default: "minimax-m2.7"
  provider: "custom"
  base_url: "https://live-turing.cn.llm.tcljd.com/api/v1"
  api_key: "YOUR_TURING_API_KEY"
  context_length: 128000

配置多个图灵模型（可选）

如果你希望在会话中随时切换多个模型，可以使用 custom_providers 定义一组命名 Provider：

custom_providers:
  - name: turing
    base_url: "https://live-turing.cn.llm.tcljd.com/api/v1"
    key_env: TURING_API_KEY       # 或直接写 api_key: "..."

model:
  default: "turing:minimax-m2.7"
  provider: "custom"
  base_url: "https://live-turing.cn.llm.tcljd.com/api/v1"
  api_key: "YOUR_TURING_API_KEY"

之后在 Hermes 会话中用 /model custom:<model-id> 切换。<model-id> 直接取 模型列表 中的接口模型 ID：

/model custom:qwen3.6-plus
/model custom:glm-5.2
/model custom:turing/gpt-5.5
/model custom:turing/claude-opus-4.8

配置项说明

配置项	说明
model.default	默认模型 ID，与图灵平台的 Model ID 一致
model.provider	固定填 custom，表示使用自定义 OpenAI 兼容端点
model.base_url	图灵平台 API 地址：https://live-turing.cn.llm.tcljd.com/api/v1
model.api_key	图灵平台 API Key，也可通过环境变量 OPENAI_API_KEY 传入
model.context_length	上下文窗口 token 数，留空表示自动检测

密钥安全

• 请妥善保管 API Key，不要提交到 git、聊天或代码片段。
• 配置文件位于 ~/.hermes/config.yaml，建议确认其权限为 600：chmod 600 ~/.hermes/config.yaml。

模型选择

Hermes 走 OpenAI 兼容接口，模型名直接填写 模型列表 里的 接口模型 ID。按厂商查看：

• MiniMax
• 阿里 DashScope
• 智谱
• OpenAI
• Claude

模型选择建议

日常 Agent 可先用上面的默认示例验证；复杂推理、长上下文或多模态场景，请到对应厂商段落按上下文、工具支持和价格选择。

开始对话

1. 启动交互式会话

hermes

进入会话后你可以直接输入任意问题，Hermes Agent 将使用图灵平台的模型完成推理与工具调用。

2. 会话内常用命令

命令	说明
/model custom:<model-id>	切换模型（仅限已配置的 Provider）
/tools	查看可用工具列表
/memory	查看 / 管理跨会话记忆
/help	查看帮助
/quit 或 Ctrl+C	退出会话

3. 接入 IDE（可选）

Hermes 通过 ACP 协议 接入 VS Code、Zed、JetBrains 等编辑器，在编辑器内直接展示对话、工具调用、文件 diff 和终端输出。具体配置请参考官方文档：Hermes Agent IDE Integration。

4. 接入聊天工具（可选）

Hermes 支持通过 Gateway 对接 Telegram / Discord / Slack / WhatsApp 等消息平台，让 AI 助手 7x24 小时响应：

hermes gateway start

详情见 Hermes Agent 官方文档。

常见问题

问题 1：请求返回 404 / invalid path

可能原因：base_url 末尾缺少 /v1。

解决方案：确认 base_url 是 https://live-turing.cn.llm.tcljd.com/api/v1，不是 https://live-turing.cn.llm.tcljd.com/api。

问题 2：请求返回 401 Unauthorized

可能原因：API Key 无效或未配置。

解决方案：

1. 在图灵平台 Portal 重新生成 API Key

2. 确认 ~/.hermes/config.yaml 中 model.api_key 已填写；或导出环境变量：

   export OPENAI_API_KEY="your-turing-api-key"

问题 3：提示找不到模型

可能原因：模型 ID 拼写错误，或使用了图灵平台未上架的模型。

解决方案：

• 核对模型 ID（区分大小写）
• 对照模型与价格确认模型可用

问题 4：hermes 命令找不到

解决方案：

1. 确认安装脚本执行成功，重新打开终端或 source ~/.zshrc / source ~/.bashrc
2. 运行 hermes doctor 诊断环境
3. 必要时重新执行一键安装脚本

问题 5：如何查看 / 修改当前配置？

hermes config show     # 打印当前配置
hermes config edit     # 用默认编辑器打开 config.yaml
hermes doctor          # 诊断配置与依赖问题

配置文件位于 ~/.hermes/config.yaml。

参考资源

• Hermes Agent 官网
• Hermes Agent GitHub
• Hermes Agent 官方文档
• AI Providers 配置文档
• 图灵平台模型列表
• 产业接入申请

技术支持

遇到问题？请访问技术支持与联系方式获取帮助。

返回

← 返回 AI 编程工具概述