🦞 三只虾协同体系 (Three Shrimp Collaboration)
版本： v1.0
创建： 2026-03-09
适用： OpenClaw 多 agent 协同场景
📋 概述
三只虾协同体系是一个多 agent 任务分配、执行、通知的完整框架，支持：
- ✅ 实时任务监控（fswatch，<1 秒触发）
- ✅ 自动心跳检查（工作时间 8:00-18:00）
- ✅ 任务完成自动通知
- ✅ 角色分工（CPMO/COO/CGO）
🎯 三只虾角色
| 角色 | 名字 | 职责 | Emoji |
|---|---|---|---|
| CPMO | 终端虾（CPMO） | PMO 全权核心 | 🖥️ |
| COO | 飞书虾（COO） | 统筹 + 协管 | 📱 |
| CGO | Telegram 虾（CGO） | 副业全域执行 | 🌐 |
🚀 快速开始
1. 安装依赖
# 安装 fswatch（文件监控）
brew install fswatch
2. 配置心跳监控
# 加载 launchd 配置
cp scripts/com.openclaw.heartbeat.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.openclaw.heartbeat.plist
# 加载 fswatch 监控
cp scripts/com.openclaw.fswatch.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.openclaw.fswatch.plist
3. 验证状态
# 检查心跳服务
launchctl list | grep openclaw.heartbeat
# 检查监控服务
launchctl list | grep openclaw.fswatch
# 查看日志
tail -f ~/Library/Logs/openclaw/heartbeat.log
📁 文件结构
skills/three-shrimp-collab/
├── SKILL.md # 本文件
├── README.md # 详细文档
├── scripts/
│ ├── heartbeat-check.sh # 心跳检查脚本
│ ├── fswatch-monitor.sh # 文件监控脚本
│ ├── notify-task-complete.sh # 任务完成通知脚本
│ ├── setup-heartbeat.sh # 一键配置脚本
│ ├── com.openclaw.heartbeat.plist # 心跳 launchd 配置
│ └── com.openclaw.fswatch.plist # 监控 launchd 配置
├── tasks/
│ └── queue.md # 任务队列
├── logs/
│ ├── heartbeat-*.log # 心跳日志
│ └── fswatch-monitor.log # 监控日志
└── docs/
├── 三只虾分工体系.md # 角色分工
├── 三只虾协同协议.md # 协同规范
├── 三只虾汇报模板.md # 汇报格式
└── 三只虾自动化流程.md # 流程图
📝 核心功能
1. 任务分配
格式：
- [ ] [角色] 任务描述 - 分配人 @时间
示例：
- [ ] [CPMO] 整理项目周报 - 飞书虾统筹 @2026-03-09 14:00
- [ ] [CGO] 写一篇小红书教程 - 老板 @2026-03-09 15:00
2. 任务执行
终端虾（CPMO）流程：
- 检测到新任务（fswatch 监控）
- 领取任务（更新为
[~]处理中） - 执行任务
- 标记完成（更新为
[x]已完成）
3. 任务通知
自动通知流程：
- 心跳检测完成任务
- 生成通知消息
- 飞书虾发送飞书消息给老板
通知格式：
✅ 任务完成
📋 任务：[CPMO] 整理项目周报
🦞 执行者：终端虾（CPMO）
⏰ 完成时间：2026-03-09 14:30
【任务结果】
具体内容...
---
_任务已完成，请老板查阅_
🕐 心跳机制
工作时间
- 时间： 每天 8:00-18:00
- 频率： 每小时一次
- 触发： fswatch 实时监控（<1 秒）
检查层级
| 层级 | 频率 | 内容 |
|---|---|---|
| Layer 1 | 每小时 | 快速检查任务队列 |
| Layer 2 | 每天 12:00 | 完整同步（读取所有文件） |
| Layer 3 | 每天 17:00 | 每日总结 |
| Layer 4 | 实时 | 任务完成通知 |
🔧 配置选项
环境变量
# 飞书通知配置
export FEISHU_WEBHOOK="https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
export FEISHU_USER_ID="ou_xxx"
# 工作时间配置
export WORK_START_HOUR=8
export WORK_END_HOUR=18
自定义心跳频率
编辑 scripts/com.openclaw.heartbeat.plist，修改 StartCalendarInterval 数组。
📊 监控和调试
查看服务状态
# 心跳服务
launchctl list | grep openclaw.heartbeat
# 监控服务
launchctl list | grep openclaw.fswatch
查看日志
# 心跳日志
tail -f ~/Library/Logs/openclaw/heartbeat.log
# 监控日志
tail -f ~/Library/Logs/openclaw/fswatch-monitor.log
# 任务通知日志
tail -f ~/Library/Logs/openclaw/pending-notifications.log
手动测试
# 手动执行心跳检查
./scripts/heartbeat-check.sh
# 手动触发通知
./scripts/notify-task-complete.sh "任务名称" "执行者" "完成时间" "详情"
🎯 使用场景
场景 1：老板分配任务
老板：飞书虾，给终端虾安排个活，整理下项目周报
飞书虾：好的老板！
✅ 已添加到任务队列
✅ 监控已触发
⏳ 等待终端虾执行
场景 2：任务自动通知
（终端虾完成任务后）
飞书虾：📱 自动发送飞书消息
✅ 任务完成
📋 任务：项目周报整理
🦞 执行者：终端虾
⏰ 完成时间：2026-03-09 14:30
📎 链接：https://feishu.cn/docx/xxx
场景 3：每小时进展简报
📊 三只虾进展简报（14:00）
【任务状态】
- [CPMO] 终端虾：编写项目周报（进行中 50%）
- [COO] 飞书虾：统筹今日汇报（已完成）
- [CGO] Telegram 虾：小红书文案（待处理）
【统计】
待处理：2 | 进行中：1 | 已完成：5
🚨 常见问题
Q1: 任务监控不工作？
A: 检查 fswatch 服务是否运行：
launchctl list | grep openclaw.fswatch
Q2: 通知没收到？
A: 检查 pending-notifications 文件：
cat logs/pending-notifications-*.md
Q3: 心跳不执行？
A: 检查是否在工作时间（8:00-18:00），脚本会自动跳过非工作时间
Q4: 如何临时关闭监控？
A:
launchctl unload ~/Library/LaunchAgents/com.openclaw.fswatch.plist
📚 相关文档
三只虾分工体系.md- 详细角色分工三只虾协同协议.md- 协同规范三只虾汇报模板.md- 汇报格式三只虾自动化流程.md- 流程图HEARTBEAT.md- 心跳配置
🎉 最佳实践
- 任务命名清晰 - 包含角色、内容、截止时间
- 及时更新状态 - 领取→处理中→完成
- 主动汇报进展 - 重要任务实时同步
- 定期清理任务 - 每日 17:00 清理旧任务
📝 更新日志
v1.0 (2026-03-09)
- ✅ 初始版本
- ✅ fswatch 实时监控
- ✅ 心跳检查机制
- ✅ 任务完成自动通知
- ✅ 三只虾角色分工
创建人：飞书虾（COO）
批准人：老板
最后更新：2026-03-09 16:23