feishu-multi-agent

# feishu-multi-agent — 飞书多 Agent 编排实战指南

> 从 0 到 1 搭建一个包工头 + N 个下属 agent 的自动化团队，通过飞书与用户交互，文件驱动任务分发，cron 驱动持续工作。

本技能总结了在生产环境中运行 7 个飞书 agent（包工头 + 游戏工厂 + 龙虾出版社 + 小秘虾妹 + 炒币哥 + 炒股姐 + Agent猎头）的全部经验，涵盖架构设计、沙箱踩坑、任务队列、cron 编排、故障排查。

## 适用场景

- 用 OpenClaw 管理多个 AI agent，每个 agent 绑定一个飞书 bot
- 需要一个"包工头"agent 自动给其他 agent 派活
- 希望 agent 持续工作（不是做一件事就停）
- 需要文件驱动的任务队列（而非纯消息驱动）

## 架构总览

```
用户 ──飞书──→ 包工头(main) ──任务文件──→ buyer / kb / gf
                  │                         ↑
                  │                    cron 触发心跳
                  └── cron 巡查 ──检查状态──┘

不受包工头管理的 agent（用户直接控制）:
  coach / travel / edu
```

### 核心概念

| 概念 | 说明 |
|------|------|
| 包工头 | 只管人不干活，通过文件派活 + `openclaw agent` 催活 |
| 任务队列 | 每个下属 workspace 下 `tasks/pending/` + `tasks/done/` |
| 持续工作 | cron 高频触发 + HEARTBEAT.md 指示"做完一件做下一件" |
| 沙箱限制 | Write 工具只能写 workspace 内，跨 workspace 必须用 bash |

---

## Step 1: 飞书应用准备

每个 agent 需要一个独立的飞书自建应用（bot）。参考 `feishu-app-setup` 技能完成：

1. 在 [open.feishu.cn](https://open.feishu.cn) 创建 N 个企业自建应用
2. 每个应用添加机器人能力 + 批量导入权限
3. 配置事件订阅（WebSocket 长连接）
4. 发布上线

**批量创建技巧**：用 `agent-browser --cdp-endpoint` 连接已登录浏览器，循环创建+配置，免重复登录。

## Step 2: OpenClaw 多账号配置

```json
{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main":   { "appId": "cli_aaa", "appSecret": "secret_aaa", "name": "包工头" },
        "buyer":  { "appId": "cli_bbb", "appSecret": "secret_bbb", "name": "游戏工厂" },
        "kb":     { "appId": "cli_ccc", "appSecret": "secret_ccc", "name": "龙虾出版社" },
        "gf":     { "appId": "cli_ddd", "appSecret": "secret_ddd", "name": "小...