🦞 三只虾协同体系 (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）流程：

1. 检测到新任务（fswatch 监控）
2. 领取任务（更新为

   [~]

   处理中）
3. 执行任务
4. 标记完成（更新为

   [x]

   已完成）

3. 任务通知

自动通知流程：

1. 心跳检测完成任务
2. 生成通知消息
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

  - 心跳配置

---

🎉 最佳实践

1. 任务命名清晰 - 包含角色、内容、截止时间
2. 及时更新状态 - 领取→处理中→完成
3. 主动汇报进展 - 重要任务实时同步
4. 定期清理任务 - 每日 17:00 清理旧任务

---

📝 更新日志

v1.0 (2026-03-09)

• ✅ 初始版本
• ✅ fswatch 实时监控
• ✅ 心跳检查机制
• ✅ 任务完成自动通知
• ✅ 三只虾角色分工

---

创建人：飞书虾（COO）
批准人：老板
最后更新：2026-03-09 16:23