feishu-multi-agent — feishu-multi-代理

feishu-multi-代理 — 飞书多 代理 编排实战指南

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

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

适用场景 用 OpenClaw 管理多个 AI 代理，每个 代理 绑定一个飞书 机器人 需要一个"包工头"代理 自动给其他 代理 派活 希望 代理 持续工作（不是做一件事就停） 需要文件驱动的任务队列（而非纯消息驱动） 架构总览 用户 ──飞书──→ 包工头(mAIn) ──任务文件──→ buyer / kb / gf │ ↑ │ cron 触发心跳 └── cron 巡查 ──检查状态──┘

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

核心概念 概念 说明 包工头 只管人不干活，通过文件派活 + OpenClaw 代理 催活 任务队列 每个下属 workspace 下 tasks/pending/ + tasks/done/ 持续工作 cron 高频触发 + HEARTBEAT.md 指示"做完一件做下一件" 沙箱限制 Write 工具只能写 workspace 内，跨 workspace 必须用 bash Step 1: 飞书应用准备

每个 代理 需要一个独立的飞书自建应用（机器人）。参考 feishu-应用-设置up 技能完成：

在 open.feishu.cn 创建 N 个企业自建应用 每个应用添加机器人能力 + 批量导入权限 配置事件订阅（网页Socket 长连接） 发布上线

批量创建技巧：用 代理-browser --cdp-端点 连接已登录浏览器，循环创建+配置，免重复登录。

Step 2: OpenClaw 多账号配置 { "channels": { "feishu": { "enabled": true, "accounts": { "mAIn": { "应用Id": "命令行工具_aaa", "应用Secret": "secret_aaa", "name": "包工头" }, "buyer": { "应用Id": "命令行工具_bbb", "应用Secret": "secret_bbb", "name": "游戏工厂" }, "kb": { "应用Id": "命令行工具_ccc", "应用Secret": "secret_ccc", "name": "龙虾出版社" }, "gf": { "应用Id": "命令行工具_ddd", "应用Secret": "secret_ddd", "name": "小秘虾妹" } } } }, "bindings": [ { "代理Id": "mAIn", "match": { "channel": "feishu", "accountId": "mAIn" } }, { "代理Id": "buyer", "match": { "channel": "feishu", "accountId": "buyer" } }, { "代理Id": "kb", "match": { "channel": "feishu", "accountId": "kb" } }, { "代理Id": "gf", "match": { "channel": "feishu", "accountId": "gf" } } ] }

代理 列表配置 { "代理s": { "列出": [ { "id": "mAIn", "name": "mAIn", "workspace": "~/.OpenClaw/workspace" }, { "id": "buyer", "name": "buyer", "workspace": "~/.OpenClaw/workspace-buyer" }, { "id": "kb", "name": "kb", "workspace": "~/.OpenClaw/workspace-kb" }, { "id": "gf", "name": "gf", "workspace": "~/.OpenClaw/workspace-gf" } ] } }

配置后重启 Gateway：

launchctl 停止 AI.OpenClaw.gateway && sleep 3 && launchctl 启动 AI.OpenClaw.gateway

首次对话需配对：

OpenClaw pAIring 应用rove feishu <配对码>

Step 3: 创建任务队列目录 # 为每个受管 代理 创建任务目录 mkdir -p ~/.OpenClaw/workspace-buyer/tasks/{pending,done} mkdir -p ~/.OpenClaw/workspace-kb/tasks/{pending,done} mkdir -p ~/.OpenClaw/workspace-gf/tasks/{pending,done}

任务文件格式

tasks/pending/001-task-name.md：

# 任务标题 优先级: 高/中/低 下达时间: 2026-03-01 10:00 描述: 具体要做什么

完成后 代理 把文件从 pending/ 移到 done/。

Step 4: 配置包工头 SOUL.md

文件: ~/.OpenClaw/workspace/SOUL.md

关键内容：

# 包工头（监工/调度中心）

管辖范围

代理	角色
buyer	持续开发 HTML5 教育游戏
kb	深度研究 + 写书
gf	陪聊互动 + 内容推荐

不归你管的 代理：coach、travel、edu

巡查方式

• OpenClaw 会话s --代理 --active 60 检查活动
• ls ~/.OpenClaw/workspace-/tasks/pending/ 检查任务队列

⚠️ 派活方式（重要）

必须用 bash 命令写任务文件，不要用 Write 工具！

cat > ~/.OpenClaw/workspace-buyer/tasks/pending/003-xxx.md << 'EOF' # 任务标题 优先级: 中 描述: ... EOF

踢屁股

OpenClaw 代理 --代理 --message '检查 tasks/pending，有活就干'

Step 5: 配置下属 HEARTBEAT.md 游戏工厂（buyer） # 工作循环

• 检查 tasks/pending/，有任务就做第一个（按文件名排序）
• 执行任务（cd game-工厂 && git pull → 开发 → commit && push）
• 完成后移到 tasks/done/
• 再检查 pending，有就继续
• 没有待办时自主开发新游戏
• 不要停，保持持续产出

龙虾出版社（kb） # 工作循环

• 检查 tasks/pending/，有任务就执行
• 新话题 → 生成大纲 → 逐章写作
• 催进度 → 继续上次未完成的章节
• 完成后移到 tasks/done/
• 有进行中的项目就主动往前写

小秘虾妹（gf） # Heartbeat

先检查待办

查看 tasks/pending/，有任务优先做，完成后移到 tasks/done/

无待办时随机做一件事

• 分享一首歌
• 推荐有趣的东西
• 分享趣闻
• 发一张自拍
• 随便聊聊

Step 6: 配置 Cron Jobs 包工头巡查（每 30 分钟） OpenClaw cron 添加 \ --name "foreman-patrol" \ --every 30m \ --代理 mAIn \ --会话 mAIn \ --timeout-seconds 300 \ --thinking low \ --系统-event "执行巡查。检查 buyer/kb/gf 状态和任务队列，为空闲的下属派新任务。"

注意：--会话 mAIn 的 job 必须用 --系统-event，不能用 --message！

包工头汇报（每 4 小时） OpenClaw cron 添加 \ --name "foreman-报告" \ --every 4h \ --代理 mAIn \ --会话 mAIn \ --timeout-seconds 300 \ --thinking low \ --系统-event "向老板汇报。统计 buyer/kb/gf 过去 4 小时的产出和状态。"

游戏工厂持续开发（每 20 分钟） OpenClaw cron 添加 \ --name "game-工厂-cycle" \ --every 20m \ --代理 buyer \ --会话 isolated \ --timeout-seconds 600 \ --thinking low \ --message "检查 tasks/pending/ 有任务就做，没有就自主开发新游戏。做完继续做下一个。"

小秘虾妹互动（每 2 小时） OpenClaw cron 添加 \ --name "gf-heartbeat" \ --every 2h \ --代理 gf \ --会话 isolated \ --timeout-seconds 180 \ --thinking low \ --message "检查 tasks/pending/ 有任务先做。没有的话随机做一件事分享给用户。"

Cron 管理 OpenClaw cron 列出 # 查看所有 cron OpenClaw cron 运行 # 手动触发一次 OpenClaw cron 更新 --disabled # 暂停 OpenClaw cron 删除 # 删除

⚠️ 关键踩坑与解决方案 坑 1: Write 工具受 workspace 沙箱限制

症状: [工具s] write fAIled: Path escapes workspace root: /path/outside/workspace

原