Hermes Agent 安装与部署指南：从零到飞书接入的完整教程
原文来源：飞书博客 | 整理发布：OctoHz
最近开源 Agent 圈里，Hermes Agent 这个名字被频繁提起。用一句话介绍——Hermes（也有人戏称"爱马仕 Agent"）本质上不是又一个简单的 AI CLI，而是一套强调长期使用、持续沉淀和自我改进的 Agent runtime。
Hermes 和 OpenClaw 看上去都在做开源 Agent，但它们解决的其实不是同一层问题：
- OpenClaw 更像入口层和调度层，重点是"消息怎么进来、会话怎么路由、平台怎么接"
- Hermes 更像 Agent 本体的执行与学习引擎，重点是"工具怎么用、经验怎么沉淀、下次怎么变强"
一、Hermes Agent 是什么？
Hermes Agent 是由 Nous Research 开发的开源 AI Agent 框架。截至 2026 年 4 月，累计完成 2 轮公开融资，总融资约 7000 万美元。
创始人 Teknium 将其定义为"介于 coding agent 与 generalist agent 之间的混合体"。
核心设计假设：AI Agent 应从交互中学习，随时间变得更有价值。Agent 不仅执行任务，还能反思、学习、进化自身行为，构建技能、记住有效方法，并持续改进。
| 维度 | Hermes Agent | 典型 Agent 框架 |
|---|---|---|
| 部署方式 | 一行 curl 安装，无需配置环境 | 需手动安装依赖、配置环境变量 |
| 执行后端 | 支持 6 种（local/Docker/SSH/Daytona/Singularity/Modal） | 通常绑定本地或单一云平台 |
| 自我进化 | 内置自学习循环，自主创建技能 | 需人工维护 prompt 和工具链 |
二、安装系统要求
- 操作系统：Linux（主流发行版）、macOS、Windows WSL2、Android Termux
- Python：3.10+
- 内存：建议 4GB+（本地运行模型需 16GB+）
- 网络：需访问 GitHub 及 LLM 提供商 API
三、安装：一行命令搞定
标准安装（推荐）
# 一行命令完整安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 安装完成后加载环境变量并启动
source ~/.bashrc && hermes
安装脚本自动完成：Python 依赖安装、路径配置、初始化向导触发。
验证安装
hermes --version
# 预期输出：hermes v0.8.0 (v2026.4.8)
手动安装（网络受限环境）
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip install -r requirements.txt
python -m hermes
四、逐步配置 Hermes Agent
Step 1：运行完整配置向导
hermes setup
会依次引导完成 LLM 提供商选择、工具启用和网关配置。
Step 2：选择 LLM 模型
hermes model
支持的 LLM 提供商：
| 提供商 | 说明 |
|---|---|
| Nous Portal | 官方 Hermes 系列模型（推荐，原生支持函数调用） |
| OpenRouter | 接入 200+ 模型，包括 Claude、GPT、Gemini |
| OpenAI | GPT-4o、GPT-4o-mini 等 |
| Kimi | 国内可用，支持长上下文 |
| MiniMax | 国内多模态模型 |
Step 3：配置工具
hermes tools
启用/禁用内置工具模块，包括：文件操作、Shell 执行、网络请求、浏览器控制等。
Step 4：配置消息网关（可选）
hermes gateway setup
支持接入：Telegram / Discord / Slack / WhatsApp / Signal / CLI
Step 5：单项配置修改
# 修改单个配置项
hermes config set <key> <value>
# 查看当前配置
hermes config list
五、六种执行后端
| 后端 | 适用场景 | 配置方式 |
|---|---|---|
| local | 本地开发调试 | 默认，无需额外配置 |
| docker | 隔离执行环境 | 需安装 Docker，hermes config set backend docker |
| ssh | 远程服务器执行 | 配置 SSH 密钥和目标主机 |
| daytona | 无服务器持久化（$5/月 VPS 可运行） | 注册 Daytona 账号后授权 |
| singularity | HPC 高性能计算集群 | 需 Singularity 环境 |
| modal | 云端函数执行 | 需 Modal 账号和 token |
六、自动化任务：内置 Cron 调度器
Hermes Agent 内置调度器，支持用自然语言定义定时任务：
# 示例：每天早 8 点总结昨日邮件
hermes schedule "每天早上 8 点，汇总我的邮件并发送到 Telegram"
# 查看已配置的任务
hermes schedule list
# 删除任务
hermes schedule remove <task-id>
七、Function Calling 子框架
独立的函数调用框架 hermes-function-calling（1,300+ Stars），适合开发者在代码中集成工具调用能力。
git clone https://github.com/NousResearch/hermes-function-calling.git
cd hermes-function-calling
pip install -r requirements.txt
from hermes_function_calling import HermesAgent
agent = HermesAgent(
model_path="NousResearch/Hermes-2-Pro-Llama-3-8B",
chat_template="chatml",
max_depth=5 # 最大递归调用深度
)
response = agent.run("北京今天天气怎么样？")
八、从 OpenClaw 迁移
一键迁移，无需手动搬配置：
hermes migrate --from openclaw
迁移内容：SOUL.md / 记忆(Memory) / 已安装技能(Skills) / API Key 配置
九、5 分钟接入飞书（重点教程）
1. 在飞书开放平台创建应用
进入 飞书开放平台，完成：
- 创建一个应用
- 开启 Bot 能力
- 记下 App ID 和 App Secret
2. 准备最小配置
vim ~/.hermes/.env
写入：
FEISHU_APP_ID=cli_xxx # 你的飞书 App ID
FEISHU_APP_SECRET=your_secret # 你的飞书 App Secret
FEISHU_DOMAIN=feishu # 飞书中国版
FEISHU_CONNECTION_MODE=websocket # 推荐，不需要公网 webhook
FEISHU_GROUP_POLICY=allowlist # 白名单模式
FEISHU_ALLOWED_USERS=ou_your_id # 允许使用的飞书用户 ID
如果只是你自己先跑通，
FEISHU_ALLOWED_USERS填你自己的 open_id 就够了。
3. 推荐 config.yaml 配置
vim ~/.hermes/config.yaml
group_sessions_per_user: true
platforms:
feishu:
extra:
ws_reconnect_interval: 120
ws_ping_interval: 30
group_sessions_per_user: true：同群不同用户各自维护上下文，避免串会话ws_reconnect_interval / ws_ping_interval：保持默认稳定配置
4. 启动 Hermes 网关
hermes gateway
# 或首次配置：
hermes gateway setup
在交互式流程里选择 Feishu / Lark。
5. 验证是否成功
私聊验证：在飞书私聊机器人，发一条消息 → 机器人能正常回复
群聊验证：拉机器人进群，@ 机器人发消息 → 机器人能正常回复
状态文件验证：
cat ~/.hermes/gateway_state.json
成功时看到：
{
"gateway_state": "running",
"platforms": {
"feishu": {
"state": "connected"
}
}
}
常见问题
Q：安装后找不到 hermes 命令？
执行 source ~/.bashrc 重新加载环境变量。检查 ~/.local/bin 是否在 PATH 中。
Q：必须使用 Hermes 系列模型吗？ 不必须。通过 OpenRouter 可接入 200+ 模型，包括 Claude、GPT-4o、Gemini 等。
Q：如何在 Telegram 上使用？
执行 hermes gateway setup，选择 Telegram，输入 BotFather 创建的 Bot Token 即可。
Q：hermes-function-calling 和 Hermes Agent 的关系？ 两者独立。function-calling 是 SDK（1,300★），适合开发者集成；Hermes Agent（52,800★）是完整应用，内置了函数调用能力。
延伸资源
暂无评论