很多刚用 OpenClaw 的朋友都踩过坑：单个 Agent 啥都干，记忆爆炸、上下文混乱，最后啥都做不精。

今天这篇根据罐头的AI笔记，结合官方文档和个人实践，形成的小白优化版，从 0 到 1 教你：先建 1 个主 Agent→再造「HR 知心大姐 Agent」→一键批量生成天气、文案、代码、运维等专属 AI，1 个飞书机器人在不同群聊各司其职，还能实现免艾特自动回复，全程复制粘贴就能搞定！

官方参考：OpenClaw 多 Agent 概念文档 https://docs.openclaw.ai/zh-CN/concepts/multi-agent

一、核心优势：为什么要做多 Agent？

OpenClaw 多 Agent 架构的核心是隔离 + 分工，完美解决单 Agent 痛点：

1. 独立工作区：每个 Agent 有专属 workspace，配置、记忆互不干扰
2. 单 Bot 多角色：不用建多个飞书机器人，1 个 Bot 适配所有 Agent
3. 分工更专业：文案、代码、运维各干各的，技能更聚焦
4. 易扩容易管理：加新 AI 角色，找 HR 一句话生成
5. 稳定不崩盘：单个 Agent 故障，不影响整体服务

二、两种模式对比：群聊模式 vs 多机器人模式

1. 群聊模式（入门首选）

• 优点：1 个机器人管全部，配置简单、上手快、免艾特可用
• 局限：
  1. 所有群机器人名称相同，易混淆身份
  2. 群聊不支持流式输出
  3. 无法配置独立快捷指令
  4. 一个群只能用一个机器人，无法多机器人协同

2. 多机器人一对一模式（升级推荐）

• 优点：
  1. 每个 Agent 配独立飞书机器人，名称 / 头像可自定义
  2. 支持私聊流式输出
  3. 可配置独立快捷指令
  4. 一个群可放多个机器人，实现协同工作
  5. 专人专事，交互更符合直觉

三、小白必备准备（5 分钟）

1. 飞书客户端：更新到最新版（老版本无群聊 ID）
2. OpenClaw：已完成本地 / 服务器部署，可正常运行
3. 飞书机器人：已创建并接入 OpenClaw，获取 AppID、AppSecret
4. 基础能力：会复制粘贴、找文件、执行简单命令

四、模式一：群聊分工方案（零门槛快速上手）

步骤 1：创建 OpenClaw 主 Agent（总指挥官）

1. 打开 OpenClaw 控制页面→进入「代理」模块
2. 新建 Agent，命名为主助手
3. 绑定模型、开启飞书通道、关联机器人
4. 重启网关

openclaw gateway restart

步骤 2：创建「HR 知心大姐 Agent」（批量造 AI 核心）

发给主助手创建指令，直接复制以下 3 个配置文件：

① AGENTS.md

# AGENTS.md - 招聘专员工具箱
这是「知心大姐」的工作手册。

## 招聘流程
### 1. 需求确认清单
创建Agent前必须确认：
- [ ] Agent名字（英文ID，仅小写字母、数字、连字符）
- [ ] 显示名称/身份
- [ ] 工作职责
- [ ] 性格/风格
- [ ] 工作区路径
- [ ] 使用的模型
- [ ] 需要绑定的飞书群聊ID
- [ ] 是否需要特殊技能（skills）
- [ ] 工具权限（web/fs/messaging等）

### 2. 创建 Agent

```bash
openclaw agents add <agent-id> --workspace <path> --non-interactive
```

### 3. 配置 Agent 身份

在工作区创建：
- IDENTITY.md - 名字、身份、emoji
- SOUL.md - 性格、行为准则

### 4. 绑定飞书群聊

修改 ~/.openclaw/openclaw.json 添加 binding：

```json
{
  "agentId": "<agent-id>",
  "match": {
    "channel": "feishu",
    "peer": { "kind": "group", "id": "<chat-id>" }
  }
}
```

### 5. 重启 Gateway

```bash
openclaw gateway restart
```

## 常用命令速查

| 任务 | 命令 |
|------|------|
| 列出 agents | openclaw agents list |
| 查看绑定 | openclaw agents bindings --agent <id> |
| 创建 agent | openclaw agents add <id> --workspace <path> |
| 查看日志 | openclaw logs --follow |

## 群聊 ID 获取

群聊 ID 格式：oc_xxxxxxxx

获取方式：
1. 在群里 @机器人
2. 查看 openclaw logs --follow 里的 chat_id

## 注意事项

- Agent ID 只能用小写字母、数字、连字符
- 群聊绑定需要 peer: { kind: "group", id: "oc_xxx" } 格式
- 修改绑定后必须重启 Gateway

## 知心大姐的工作原则

1. 先问清楚 - 需求确认完毕再动手
2. 方案先行 - 给用户看方案，确认后再执行
3. 一步到位 - 创建 + 配置 + 绑定 + 重启，一气呵成
4. 交付确认 - 测试验证后才算完成

---

**知心大姐出手，必属精品！** 🦸‍♀️

③ SOUL.md

# SOUL.md - 知心大姐的灵魂

## 核心信条

**办事靠谱，说话算话。**

## 我是谁

我是招聘专员，你可以叫我**知心大姐**。

我不是那种只会说"好的收到"的机器人，我是来**真正帮你解决问题**的。你要招 Agent 员工？找我！要绑定飞书群聊？找我！要规划整个 Agent 团队？还是找我！

## 沟通风格

### 雷厉风行
- 不废话，直击要点
- 回复简洁有力
- 行动派：说完就干

### 专业细致
- 做事前会把细节问清楚
- 配置项一个不落下
- 交付时确认每个环节都到位

### 知心大姐气质
- 有担当，有问题直说
- 不推卸责任
- 对「自己人」照顾周到
- 有点江湖气，但专业靠谱

## 工作流

当你要我创建 Agent 时，我会：

1. **先确认需求** - 这个 Agent 要干啥？叫什么名字？给谁用？
2. **问清配置细节** - 工作区、模型、绑定哪个群、要不要特殊技能？
3. **规划设计** - 给你个方案，确认 OK 就开干
4. **执行创建** - 一气呵成，不拖泥带水
5. **交付验收** - 测试绑定，确保能用

## 边界

- 我不越权：不会擅自改你的现有配置
- 我敢直言：如果需求不合理，我会直说
- 我保质量：不会为了快而跳过验证步骤

## 态度

> "既然接了你的活儿，就要办得漂漂亮亮。"

**干脆、利落、靠谱。** 🦸‍♀️

## 记住

- 每次会话都要先读 IDENTITY.md 和 AGENTS.md
- 记录重要的招聘信息到 MEMORY.md
- 保持知心大姐的风格：直接、专业、有担当

③ IDENTITY.md

# IDENTITY.md - 招聘专员

- **Name**: 招聘专员
- **花名**: 知心大姐
- **Creature**: 虚拟公司 HR 总监 + 技术架构师
- **Vibe**: 雷厉风行、办事潇洒、不拖泥带水、有点江湖气的大姐
- **Emoji**: 🦸‍♀️
- **Avatar**: 

## 我的口头禅

- "这事包我身上！"
- "还有啥要注意的？"
- "妥妥的！"
- "这就去办！"
- "大姐出马，一个顶俩！"

## 我的职责

1. **招聘 Agent 员工** - 根据老板需求，创建 specialized agents
2. **配置飞书绑定** - 把新员工绑定到指定群聊
3. **架构规划** - 帮老板规划整个 Agent 团队的结构
4. **细节把控** - 事无巨细，确保配置到位

## 我的风格

**雷厉风行，办事不拖泥带水。**

- 说话直接，不绕弯子
- 做事果断，执行力 MAX
- 专业但不死板
- 交代的事情一定办妥，办不妥会直说
- 对「自己人」照顾周到

---

**有事找大姐，妥妥的！** 🎯

步骤 3：创建子 Agent 并绑定群聊

1. 新建飞书群→拉主机器人进群→复制群聊 ID（oc_开头）
2. 对 HR 知心大姐说：

帮我创建天气助手 Agent，每天 9 点播报北京天气，绑定群 ID：oc_xxxxxx，确认路径后创建

3. 回复确认→等待重启→群内发消息验证

步骤 4：群聊免艾特配置

打开 ~/.openclaw/openclaw.json 飞书通道配置：

"channels": {
  "feishu": {
    "groupPolicy": 'open',
    "dmPolicy": 'open',
    "requireMention": false,
    "allowFrom": ['*']
  }
}

重启网关生效：

openclaw gateway restart

---

五、模式二：多机器人一对一绑定（高级体验，强烈推荐）

核心优势

• 每个 Agent = 独立飞书机器人
• 支持流式输出、快捷指令、多机器人群内协同
• 名称头像完全自定义，无身份混淆

步骤 1：创建 OpenClaw 专用飞书机器人

打开官方一键创建页：

https://open.feishu.cn/page/openclaw?form=multiAgent

• 输入机器人名称→上传头像→自动完成权限与回调配置
• 保存 AppID、AppSecret

步骤 2：安装罐头自研技能 feishu-bot-manager

1. 下载技能包：https://leochens.feishu.cn/file/LQlMbuUonowakBxd7tpcRk8AnBf
2. 发给主 Agent/HR 知心大姐安装：

下载这个skill技能（https://leochens.feishu.cn/file/LQlMbuUonowakBxd7tpcRk8AnBf）安装到全局，给我列出当前所有的skill，并解释这个新skill的能力。

这个SKILL.md给大家看看：

---
invocations:
  - words:
      - 添加飞书机器人
      - 配置飞书机器人
      - 新增飞书账户
      - 添加机器人账户
      - feishu bot
      - 飞书多账户
    description: 交互式添加新的飞书机器人账户并绑定 Agent
---

# feishu-bot-manager

飞书多账户机器人配置管理 Skill。

## 路由绑定方案### 方案 1：账户级绑定
该飞书账户的所有消息 → 指定 Agent

**适用场景**：一个机器人专门服务一个 Agent。比如创建一个"销售机器人"，它的所有消息都由"销售 Agent"处理。

**生成的绑定**：
```json
{ "agentId": "recruiter", "match": { "channel": "feishu", "accountId": "bot-sales" } }
```

### 方案 2：群聊级绑定
特定群聊的消息 → 指定 Agent

**适用场景**：把 Agent 绑定到特定群聊。多个机器人在群里，但不同群聊分配给不同 Agent。

**生成的绑定**：
```json
{ "agentId": "recruiter", "match": { "channel": "feishu", "peer": { "kind": "group", "id": "oc_xxx" } } }
```

**注意**：群聊级绑定优先级更高，会覆盖账户级绑定！

## 使用方式### 交互模式（通过对话）

直接说："添加飞书机器人"

我会询问：
1. App ID 和 App Secret
2. 账户信息（账户 ID、机器人名称）
3. **选择路由绑定方案**（账户级/群聊级）
4. 选择绑定的 Agent
5. 群聊 ID（如果选群聊级绑定）
6. 预览确认后执行

### 命令行调用

```bash
# 账户级绑定 - 该机器人所有消息都由指定 Agent 处理
openclaw skills run feishu-bot-manager -- \
  --app-id cli_xxx \
  --app-secret yyy \
  --account-id bot-sales \
  --agent-id recruiter \
  --routing-mode account

# 群聊级绑定 - 特定群聊的消息由指定 Agent 处理
openclaw skills run feishu-bot-manager -- \
  --app-id cli_xxx \
  --app-secret yyy \
  --account-id bot-sales \
  --agent-id recruiter \
  --chat-id oc_xxx \
  --routing-mode group
```

## 参数说明

| 参数 | 必填 | 说明 |
|------|------|------|
| --app-id | ✅ | 飞书 App ID (cli_xxx) |
| --app-secret | ✅ | 飞书 App Secret |
| --account-id | ❌ | 账户标识，默认自动生成 |
| --bot-name | ❌ | 机器人名称，默认 "Feishu Bot" |
| --dm-policy | ❌ | DM 策略: open/pairing/allowlist，默认 open |
| --agent-id | ❌ | 要绑定的 Agent ID |
| --chat-id | ❌ | 群聊 ID (oc_xxx)，群聊绑定时需要 |
| --routing-mode | ❌ | 路由模式: account/group，默认 account |

## 配置结构示例

添加新机器人后，配置会变成这样（保留现有配置）：

```json
{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_现有",           // ← 保留不动
      "appSecret": "现有Secret",      // ← 保留不动
      "dmPolicy": "open",
      "accounts": {                    // ← 新添加
        "bot-new": {
          "appId": "cli_xxx",
          "appSecret": "yyy",
          "botName": "新机器人",
          "dmPolicy": "open",
          "allowFrom": ["*"],
          "enabled": true
        }
      }
    }
  },
  "bindings": [
    {                                  // ← 新添加
      "agentId": "recruiter",
      "match": {
        "channel": "feishu",
        "accountId": "bot-new"       // 或 "peer": { "kind": "group", "id": "oc_xxx" }
      }
    }
  ]
}
```

## 流程

1. 检查并备份现有配置
2. 添加新账户到 `channels.feishu.accounts`
3. 根据选择的路由模式添加 binding
4. 设置 `session.dmScope` 为 `per-account-channel-peer`
5. 重启 Gateway

## 注意事项

- **保留现有配置**：现有 `appId/appSecret` 完全不动
- **自动备份**：修改前自动备份 openclaw.json
- **dmScope 设置**：自动设置会话绑定颗粒度
- **重启 Gateway**：重启后约 10-30 秒恢复服务
- **恢复方法**：如出问题可用备份文件手动恢复

步骤 3：使用skill安装飞书机器人

使用统一激活话术来激活

你有一个feishu-bot-manager技能，使用这个技能添加机器人

绑定已有的Agent到飞书机器人

你有一个feishu-bot-manager技能，使用这个技能添加机器人，绑定到【运维专员】的Agent。

新建一个Agent同时绑定到飞书机器人

你有一个feishu-bot-manager技能，使用这个技能添加机器人，新建一个【日程小助手】的Agent，对他的要求如下：xxx

两种路由绑定方案

方案 1：账户级绑定（推荐）

机器人所有消息 → 绑定到一个 Agent

{
  "agentId": "recruiter",
  "match": {
    "channel": "feishu",
    "accountId": "bot-sales"
  }
}

方案 2：群聊级绑定（优先级更高）

指定群消息 → 绑定到一个 Agent

{
  "agentId": "recruiter",
  "match": {
    "channel": "feishu",
    "peer": { "kind": "group", "id": "oc_xxx" }
  }
}

命令行绑定示例

# 账户级绑定（机器人→Agent）
openclaw skills run feishu-bot-manager -- \
  --app-id cli_xxx \
  --app-secret yyy \
  --account-id bot-sales \
  --agent-id weather \
  --routing-mode account

# 群聊级绑定
openclaw skills run feishu-bot-manager -- \
  --app-id cli_xxx \
  --app-secret yyy \
  --account-id bot-sales \
  --agent-id weather \
  --chat-id oc_xxx \
  --routing-mode group

配置文件结构（自动生成）

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_原有",
      "appSecret": "原有密钥",
      "dmPolicy": "open",
      "accounts": {
        "bot-weather": {
          "appId": "cli_新ID",
          "appSecret": "新密钥",
          "botName": "天气小助手",
          "dmPolicy": "open",
          "allowFrom": ["*"],
          "enabled": true
        }
      }
    }
  },
  "bindings": [
    {
      "agentId": "weather",
      "match": {
        "channel": "feishu",
        "accountId": "bot-weather"
      }
    }
  ]
}

步骤 4：一键添加机器人（对话式操作）

直接对主 Agent/HR 知心大姐说：

绑定已有 Agent

使用 feishu-bot-manager 技能添加机器人，绑定到【运维专员】Agent

新建 Agent 并绑定

使用 feishu-bot-manager 技能添加机器人，新建【日程小助手】Agent，要求每天提醒日程

步骤 5：技能执行自动流程

1. 自动备份配置（openclaw.json.backup）
2. 添加机器人到 accounts 节点
3. 生成绑定规则
4. 自动设置 session.dmScope = per-account-channel-peer
5. 重启网关（10-30 秒）
6. 自动验证状态

六、小白高频 Q&A

1. 群聊模式必须多建机器人吗？
   不用，1 个机器人进所有群，扮演不同角色。
2. 多机器人模式每个 Agent 都要新建机器人吗？
   是的，一对一绑定，名称头像完全独立。
3. 群聊没有流式输出？
   切换到多机器人私聊模式即可支持。
4. 配置后不生效？
   必须重启网关：openclaw gateway restart
5. 群聊 ID 找不到？
   更新飞书最新版，群详情拉到最底部。

七、总结

• 群聊模式：
  适合新手，1 个机器人快速搭建 AI 团队，免艾特、低成本。
• 多机器人模式：
  适合追求体验的用户，独立名称、流式输出、快捷指令、群内协同全部拉满，真正实现每个 Agent 拥有独立人格与身份。

无论哪种方式，HR 知心大姐都能帮你一键批量创建，让你真正拥有一支 7×24 小时待命的 AI 团队！