别急着卸载 OpenClaw,Hermes 真正的用法不是替代它

# OpenClaw × Hermes 接入操作手册 v1## 1. 文档目标本文档用于指导把 **Hermes** 接入到 **OpenClaw** 体系中，并形成以下正确结构：**Feishu / WebChat → OpenClaw main →（按需内部委派）→ Hermes worker → 结果回到同一个聊天**适用场景：- 用户只想和 **一个 OpenClaw** 对话- OpenClaw 作为主编排层 / 主调度层- Hermes 作为下层执行型 worker- 内容型任务由 main 自己处理- 执行型任务由 main 内部委派给 Hermes- 最终结果仍回到同一个聊天入口---## 2. 最终正确架构## 2.1 角色分工### OpenClaw main负责：- 接住所有入口消息- 理解任务- 判断任务类型- 自己处理内容型任务- 按需委派 Hermes- 汇总和回传结果### Hermes worker负责：- 文件操作- 本地执行- shell / terminal- 多步骤执行任务- 路径、目录、桌面、本地落盘- 执行链### Feishu / WebChat只负责：- 作为统一聊天入口- 接收最终结果---## 3. 一句话总结系统设计**OpenClaw main 是“大脑和调度员”，Hermes worker 是“执行员和落地层”。**也就是说：- **main 负责理解、规划、调度**- **Hermes 负责执行、落盘、返回真实结果**---## 4. 错误路线与正确路线## 4.1 错误路线**试图在同一个 Feishu 聊天里，直接通过消息前缀切换顶层 agent**例如想做：- `main:` → 直接切到 main- `hermes:` → 直接切到 Hermes### 为什么这是错误路线因为在实际系统里：- 消息进入 OpenClaw 时，agent 往往已经根据会话归属被选定- 插件经常在 agent 选定之后才生效- 这种插件通常只能影响 prompt，不能改顶层 agent 选择- 同一个 peer / session 很容易被“粘”到某个 agent### 典型现象- `main:` 也落到 `hermes-worker`- `hermes:` 也落到 `hermes-worker`- 两条消息进入同一个 Hermes session这说明：**问题不在“前缀判断条件”，而在“前缀判断时机太晚”。**---## 4.2 正确路线**Feishu 永远先进 main，再由 main 内部委派 Hermes**即：- `main:` → main 自己处理- `hermes:` → main 识别后，内部调用 Hermes- 不带前缀 → 默认 main 自己处理，后续再加自动路由这才是最终应采用的结构。---## 5. 最终验收标准接入成功必须同时满足下面 4 条：### 1. 顶层 Feishu 会话属于 main而不是直接落在 Hermes### 2. `main:` 由 main 自己处理不会委派给 Hermes### 3. `hermes:` 由 main 内部委派给 Hermes worker而不是直接切顶层会话### 4. Hermes 执行结果回到同一个 Feishu 聊天并且有真实、可验证的本地结果---## 6. 推荐接入步骤## 第 0 步：前提条件先确保下面几项已经打通：- Hermes API 可用- OpenClaw gateway 可用- Feishu 已接入 OpenClaw- `hermes-worker` 已存在并可解析---## 第 1 步：冻结核心层以下文件默认视为 **核心层**，不要轻易修改：- `~/.openclaw/openclaw.json`- `~/.hermes/.env`### 原则- 非系统维护任务不要改核心层- 修改前必须备份- 实验 skill / 插件 / 路由，优先改工作层，不先改核心层---## 第 2 步：确保 Feishu 顶层入口固定归 main这是整个系统设计里最关键的一步。### 目标不是让 Feishu 消息直接切到 Hermes，  而是：**Feishu 顶层入口只归 main。**### 检查点- Feishu 入口绑定到 main- Hermes 不直接拥有 Feishu 顶层会话- 之前误落在 Hermes 的 session 归属需要清掉---## 第 3 步：实现 main 内部委派机制### 正确逻辑- `main:` → main 直接处理- `hermes:` → main 内部调用 / 派发给 Hermes- 不带前缀 → 先全部留在 main### 注意不要再做“入口级切 agent”，  要做的是：**main 内部 dispatcher**---## 第 4 步：第一阶段只做显式路由，不做自动路由建议第一阶段只支持：- `main:`- `hermes:`### 原因显式路由稳定前，不要做自动语义路由。  否则问题会变得很难排查。---## 第 5 步：真实入口验收在同一个 Feishu 聊天里测试：### 测试 1：main```text@LingClaw main: 只回复 MAIN_OK