# Hermes Agent 安装与部署完整教程：从零到飞书接入

> Nous Research 开源 AI Agent 框架，一行命令安装，6种执行后端，内置自学习循环。本文覆盖安装、配置、飞书接入全流程。

## Hermes Agent 安装与部署指南：从零到飞书接入的完整教程

> 原文来源：[飞书博客](https://www.feishu.cn/content/article/7630758640865037530) | 整理发布：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

---

## 三、安装：一行命令搞定

### 标准安装（推荐）

```bash
# 一行命令完整安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 安装完成后加载环境变量并启动
source ~/.bashrc && hermes
```

安装脚本自动完成：Python 依赖安装、路径配置、初始化向导触发。

### 验证安装

```bash
hermes --version
# 预期输出：hermes v0.8.0 (v2026.4.8)
```

### 手动安装（网络受限环境）

```bash
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip install -r requirements.txt
python -m hermes
```

---

## 四、逐步配置 Hermes Agent

### Step 1：运行完整配置向导

```bash
hermes setup
```

会依次引导完成 LLM 提供商选择、工具启用和网关配置。

### Step 2：选择 LLM 模型

```bash
hermes model
```

支持的 LLM 提供商：

| 提供商 | 说明 |
|--------|------|
| Nous Portal | 官方 Hermes 系列模型（推荐，原生支持函数调用） |
| OpenRouter | 接入 200+ 模型，包括 Claude、GPT、Gemini |
| OpenAI | GPT-4o、GPT-4o-mini 等 |
| Kimi | 国内可用，支持长上下文 |
| MiniMax | 国内多模态模型 |

### Step 3：配置工具

```bash
hermes tools
```

启用/禁用内置工具模块，包括：文件操作、Shell 执行、网络请求、浏览器控制等。

### Step 4：配置消息网关（可选）

```bash
hermes gateway setup
```

支持接入：Telegram / Discord / Slack / WhatsApp / Signal / CLI

### Step 5：单项配置修改

```bash
# 修改单个配置项
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 内置调度器，支持用自然语言定义定时任务：

```bash
# 示例：每天早 8 点总结昨日邮件
hermes schedule "每天早上 8 点，汇总我的邮件并发送到 Telegram"

# 查看已配置的任务
hermes schedule list

# 删除任务
hermes schedule remove <task-id>
```

---

## 七、Function Calling 子框架

独立的函数调用框架 `hermes-function-calling`（1,300+ Stars），适合开发者在代码中集成工具调用能力。

```bash
git clone https://github.com/NousResearch/hermes-function-calling.git
cd hermes-function-calling
pip install -r requirements.txt
```

```python
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 迁移

一键迁移，无需手动搬配置：

```bash
hermes migrate --from openclaw
```

迁移内容：SOUL.md / 记忆(Memory) / 已安装技能(Skills) / API Key 配置

---

## 九、5 分钟接入飞书（重点教程）

### 1. 在飞书开放平台创建应用

进入 [飞书开放平台](https://open.feishu.cn/)，完成：
- 创建一个应用
- 开启 Bot 能力
- 记下 **App ID** 和 **App Secret**

### 2. 准备最小配置

```bash
vim ~/.hermes/.env
```

写入：

```bash
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 配置

```bash
vim ~/.hermes/config.yaml
```

```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 网关

```bash
hermes gateway
# 或首次配置：
hermes gateway setup
```

在交互式流程里选择 **Feishu / Lark**。

### 5. 验证是否成功

**私聊验证**：在飞书私聊机器人，发一条消息 → 机器人能正常回复

**群聊验证**：拉机器人进群，@ 机器人发消息 → 机器人能正常回复

**状态文件验证**：

```bash
cat ~/.hermes/gateway_state.json
```

成功时看到：

```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★）是完整应用，内置了函数调用能力。

---

## 延伸资源

- [Hermes Wiki](https://github.com/cclank/Hermes-Wiki)
- [Hermes Agent 橙皮书](https://github.com/alchaincyf/hermes-agent-orange-book/)
- [YouTube 教程合集](https://www.youtube.com/watch?v=bPMCvFYxcxk)
- [官方 GitHub](https://github.com/NousResearch/hermes-agent)

---

**分类**：教程
**标签**：安装 · Agent · 接入
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1685