🔥 加入飞创 AI 交流群

飞创 Token 交流群 · 扫码或进入官网加入
Hermes Agent 教程 — Nous Research 开源终端 AI Agent,通过 Custom Endpoint 无代码接入 飞创 AI 中转站,支持 Telegram、Discord、Slack 等多渠道集成。
关于 Hermes Agent
Hermes Agent 是由 Nous Research 出品的开源终端 AI Agent,在你的终端中提供强大的工具调用、文件读写和代码执行能力。通过内置的 Custom Endpoint 能力,Hermes 可以无缝接入任何 OpenAI 兼容 API — 包括 飞创 AI 中转站,全程无需写任何代码或插件。
- 官方主页:https://hermes-agent.nousresearch.com
- 快速开始:https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
- GitHub:https://github.com/NousResearch/hermes-agent
Hermes Agent 完全开源,你可以在 Hermes Agent 的 GitHub 仓库 浏览源码、提交 Issue 或参与贡献。本教程涵盖安装、配置,以及将 Hermes Agent 对接 飞创 AI 中转站 的完整步骤。
🌟 核心特性
智能代理能力
- 工具调用:原生支持工具调用、文件读写和代码执行
- 持久记忆:支持后台常驻运行,拥有长期记忆
- 技能系统:通过
hermes skills命令搜索和安装技能包 - 多界面支持:支持命令行和 TUI(终端 UI)两种模式
多渠道集成
- 消息网关:通过
hermes gateway统一管理所有渠道 - 多平台支持:可接入 Telegram、Discord、Slack、WhatsApp 等消息应用
- 持续在线:作为后台服务常驻运行
开放的模型生态
- 自定义 Provider:内置 Custom Endpoint 支持,可接入任何 OpenAI 兼容 API
- 交互式配置:通过
hermes model命令以交互菜单方式完成配置,无需编辑配置文件 - 灵活切换:支持在对话中通过
/model命令随时切换模型
📦 接入前准备
准备信息
- 安装 Hermes Agent(见下方安装步骤)
- 一个可用的 飞创 AI 中转站 API Key(在控制台生成)
🚀 第一步:安装 Hermes Agent
Linux / macOS / WSL2
在终端中运行官方一键安装脚本:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完成后,重新加载终端环境变量:
source ~/.bashrc如果你使用的是 zsh(macOS 默认),请改为:
source ~/.zshrcWindows
Windows 用户注意:
Hermes Agent 本身不直接支持 Windows 原生环境,你需要先安装 WSL2(Windows Subsystem for Linux 2),然后在 WSL2 终端中运行上方的 Linux/macOS 安装命令。
验证安装
输入以下命令验证 Hermes 是否安装成功:
hermes --version如果显示版本号,说明安装成功 🎉。
🔧 第二步:配置 飞创 AI 中转站(核心步骤)
这是整个接入流程中最关键的一步。Hermes Agent 提供了 交互式菜单,用户无需写任何代码或手动编辑配置文件,只需根据提示填入 飞创 AI 中转站 的 URL、Key 和模型名即可。
在终端中运行:
hermes model这会打开一个交互式菜单,使用键盘上下方向键选择选项,回车确认。
配置步骤
1. 选择 Provider
用方向键滚动到 Custom Endpoint(或类似的「自定义端点」选项),按回车确认。
2. 填写 Base URL
输入你的 飞创 AI 中转站 地址,例如:
https://feichuangtech.cn/v1⚠️ 地址必须以
结尾,这是最常见的配置错误来源。
3. 填写 API Key
输入你在 飞创 AI 中转站 控制台生成的 API Key,例如:
sk-xxxxxxxxxxxxxxxx4. 填写模型名称
输入你想使用的模型,例如:
gpt-5.6-sol模型名称必须与 飞创 AI 中转站 控制台中的模型 ID 完全一致,否则会报模型不存在的错误。
5. 确认保存
按提示确认,配置完成。
关键配置说明
| 配置项 | 说明 | 示例 |
|---|---|---|
| Base URL | 飞创 AI 中转站 地址,必须以 /v1 结尾 | https://feichuangtech.cn/v1 |
| API Key | 飞创 AI 中转站 控制台生成的令牌 | sk-xxxxxxxxxxxxxxxx |
| Model | 模型名称,需与 飞创 AI 中转站 实际暴露的模型 ID 一致 | gpt-5.6-sol |
✅ 第三步:验证是否接入成功
配置完成后,直接启动 Hermes 开始对话:
hermes或使用更现代的 TUI 模式(终端图形界面):
hermes --tui随便输入一条测试消息,例如:
你好,告诉我今天星期几如果模型正常返回回复,说明接入成功 🎉。
查看和切换模型
在对话中直接输入以下命令,可以查看当前使用的模型,并快速切换:
/model你也可以随时再次运行 来覆盖之前的配置,重新填入新的 URL、Key 或模型名。
❓ 常见问题
| 问题 | 解决方案 |
|---|---|
| 回复为空或报错 | 检查 Base URL 是否以 /v1 结尾 |
| 提示模型不存在 | 确认模型名称与 飞创 AI 中转站 控制台中的模型 ID 完全一致 |
| 提示 API Key 无效 | 在 飞创 AI 中转站 控制台重新生成一个 Key,然后再次运行 hermes model |
| 不知道怎么进入配置菜单 | 在终端输入 hermes model 并回车 |
| 想切换模型 | 重新运行 hermes model,或在对话中输入 /model |
| 提示 context 不够 | Hermes 要求模型至少支持 64K tokens,请更换支持更大上下文的模型 |
| 想修改之前的配置 | 再次运行 hermes model,会覆盖之前的设置 |
| Windows 上无法安装 | Hermes 不原生支持 Windows,请先安装 WSL2,在 WSL2 终端中执行安装命令 |
🎯 后续进阶(可选)
接入 飞创 AI 中转站 成功后,你还可以继续探索 Hermes Agent 的更多能力:
启动消息网关
将 Hermes 连接到 Telegram、Discord、Slack 等消息应用:
hermes gateway setup搜索并安装技能
Hermes 内置技能商店,可以一键扩展能力:
hermes skills search <关键词>查看所有可用命令
hermes --help小贴士
接入 飞创 AI 中转站 后,所有 Hermes Agent 的后续能力(消息网关、技能调用、后台常驻等)都会通过 飞创 AI 中转站 调用你选择的模型,无需再为每个功能单独配置模型提供商。