团队会话编排

要解决什么问题

当你需要把一件事拆给多个「成员代理」并行或串行处理时，常见坑是：子代理不知道自己的身份、读到主控的 SOUL.md 导致人格串线、成员之间互相 @ 造成信息分叉，最后主控既当调度又亲自写代码，团队形态名存实亡。

本技能围绕 一个主控、多成员、零横向沟通：所有任务由主控 sessions_spawn / sessions_send 下发，产出回到主控再验收或打回。

技能如何工作

Sessions Spawn 三要素缺一不可：

• agentId：激活成员身份
• cwd：指向成员子目录，隔离 workspace（否则子代理会读父目录 SOUL.md）
• task：明确做什么、输出什么

配置侧为每个成员建独立目录并写入成员 SOUL.md，在 openclaw.json 中配置 allowAgents（常用 ["*"] 表示允许主控 spawn，子权限仍由主控约束），重启 Gateway 后按任务类型选型：

| 场景 | 方式 |
|------|------|
| 一次性 | sessions_spawn + mode="run" |
| 多轮 | sessions_spawn + mode="session"，后续 sessions_send |
| 已有会话 | 直接 sessions_send |

派单后子代理完成会唤醒主控：读成员 workspace 产物、检查是否达标、通过 / 重派 / 换人 / 上报用户。沟通铁律包括统一汇报格式、失败三次递进处理，以及 主代理不执行——需要「做」的事第一反应是派给谁。

适用边界与注意点

• Forbidden Error：多为未配置 allowAgents，改配置并重启 gateway。
• 人格错乱：检查 cwd 是否存在且目录下有对应 SOUL.md。
• 空跑或敷衍完成：任务过大要拆小、能力不够可预写脚本让子代理只跑 python3 xxx.py、描述要极简（做什么 / 输出什么 / 禁止什么）。
• 复杂任务建议设 runTimeoutSeconds、任务带编号、重要操作前备份配置；产物统一落在成员 workspace，由主控读取汇总。