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