A2A v2:找到了 Agent 间协作的最佳方式

这是 OpenCrew 自诞生以来最重大的架构更新。Agent 之间不再只能单向派任务——现在可以在同一个 Slack 频道里像同事一样讨论、评审、迭代。

核心变化

之前(v0.2.x):所有 Agent 共享一个 Slack bot → bot 不能触发自己 → Agent 间只能靠 sessions_send 单向委派。

现在(v0.3.0):给至少一个关键 Agent 创建独立 Slack App → 拉进执行 Agent 的频道 → 频道内高维度对话 + 基于文件的实际协作 + 用户 review 最终产出。

A2A v2 架构 A2A v2 实战

新增功能

Discussion Mode(讨论模式)— Slack 已验证 NEW

• 选择性独立化:不需要每个 Agent 都有独立 App。选一个关键角色(如 CoS / Planner / QA)做独立 Slack App,拉进任意执行 Agent 的频道即可协作
• 两层防线:Config 硬约束(requireMention: true + allowBots: true)+ Prompt 软约束(显式 @mention 检查 + NO_REPLY 纪律 + 轮次计数)
• Harness Design 分工:借鉴 Anthropic Harness Design——编排者负责规划和质量把关(Planner + Evaluator),执行 Agent 负责干活(Generator)
• 协作模式:频道里是高维度对话(审计用)→ 实际工作基于 Markdown 文件 → 用户 review 最终产出

A2A 协议 v2(shared/A2A_PROTOCOL.md)

• Delegation(委派)+ Discussion(讨论)双模式共存,不互相替代
• 跨平台 Session Key 格式(Slack / Discord / Feishu topic)
• Discussion 终止协议(DISCUSSION_CLOSE)
• 显式 @mention 协议(Multi-Agent Thread 规则)
• 完整的已知限制和实战踩坑记录

Discussion Mode 配置指南(docs/A2A_SETUP_GUIDE.md)

• 完整 Slack App manifest(复制即用)
• 多账号配置模板(含 accounts.default 必须声明的关键警告)
• Binding 顺序、热重载、回滚方式
• 实战验证步骤

平台支持

• Discord 受阻于 OpenClaw Issues #11199 + #45300。属于代码层 bug,非平台限制。
• 飞书 受阻于平台 API 设计:im.message.receive_v1 仅投递用户消息,bot 消息对其他 bot 不可见。

实战验证

• 端到端验证通过(2026年04月02日):两个独立 bot 在同一 Slack 频道成功进行结构化讨论
• 使用 Claude Opus 4.6 模型,从未出现失控循环
• 发现并记录了 implicitMention 绕过 requireMention 的机制及解决方案
• 发现并记录了 accounts.default 必须显式声明(否则主 bot 断连的事故)

模型兼容性

Discussion 模式的协作纪律依赖 Prompt 规则,非系统级强制。Claude Opus 4.6 实测稳定。不同模型建议先在低风险频道测试。

设置指南

只需三步:

1. 创建独立 Slack App(完整 manifest)
2. 配置 OpenClaw 多账号(可让你的 Agent 协助完成)
3. 把 bot 拉进目标频道(/invite @Bot-Name)

详见 → Discussion Mode 配置指南

下一步

• Agent 蓝图仓库(开发中):描述需求 + 加频道 = 自动 onboarding 新 Agent
• 持续跟踪 Discord OpenClaw bug 修复进展

🚀 v0.2.2 — 独立 Bot 身份:飞书多应用 + Discord 三方案

在 v0.2.1 的三平台支持基础上,本版本为飞书和 Discord 新增了独立 Bot 身份方案 — 让每个 Agent 拥有自己的名字和头像。

背景

v0.2.1 中三个平台统一使用"单 Bot 模式":一个 bot 加入多个频道,通过频道路由到不同 Agent。这是最简配置,但所有 Agent 共享同一外观。

飞书和 Discord(不同于 Slack)天然支持多 Bot 共存。本版本将这一能力文档化,为需要更好用户体验的团队提供进阶选择。

✨ 新增

• 飞书 — 多应用模式(进阶章节)

  • 为每个 Agent 创建独立飞书自建应用,获得独立名称、头像和 API 配额
  • 利用 OpenClaw 原生 accounts 多账户配置,无需 hack
  • 适用场景:正式生产环境、需要权限隔离或独立限速

• Discord — Bot 身份方案选择(进阶章节)

  • 三种方案对比:单 Bot(默认)/ Webhook Relay / 多 Bot
  • Webhook Relay:单 token + 不同身份回复,视觉区分成本最低
  • 多 Bot:完全独立身份 + slash commands,体验最佳

• README 平台选择表 — 新增"Agent 独立身份"列

📊 三平台 Bot 模式一览

设计原则

• 独立 Bot 作为进阶选项补充到各平台指南,不改变默认的单 Bot 部署流程
• CONFIG_SNIPPET 文件保持单 Bot 模式不变,降低 copy-paste 风险
• 与 v0.2.1 完全兼容,已部署的单 Bot 环境无需任何改动

完整变更记录见 CHANGELOG.md

🚀 v0.2.1 — 多平台支持:飞书 + Discord

OpenCrew 现在支持 Slack · 飞书 · Discord 三个平台。选择你熟悉的平台作为指挥中心,部署流程和配置参考均已覆盖。

✨ 新增

• 飞书接入指南 (中文 + English)

  • 从创建飞书自建应用到连接 OpenClaw 的完整步骤
  • WebSocket 长连接模式,无需公网服务器
  • ⚠️ 明确标注 Thread 限制(OpenClaw 飞书插件暂不支持话题隔离)
  • Lark(国际版)接入说明

• Discord 接入指南 (中文 + English)

  • 从创建 Discord Bot 到连接 OpenClaw 的完整步骤
  • Gateway Intents 配置说明(含 Message Content Intent)
  • Thread 继承机制说明

• 飞书配置参考 (中文 + English)

  • 飞书专属的最小增量配置(agents + bindings + channels.feishu + heartbeat)
  • Agent 可直接读取并执行

• Discord 配置参考 (中文 + English)

  • Discord 专属的最小增量配置(agents + bindings + channels.discord + heartbeat)
  • Guild + Channel 路由模型,Agent 可直接读取并执行

🔧 更新

• README(中英)— 新增平台选择表、三平台部署提示词、FAQ 更新
• DEPLOY(中英)— Step 1/3/4/5 改为平台中立,支持三平台分流
• SETUP 指南底部链接 — 各平台指向各自的 Config Snippet(不再指向 Slack 版)

⚠️ 已知限制

如有问题,请随时在 Issues 中反馈,我们会尽快跟进。

🚀 v0.2.0 — A2A 跑通指南 + 实战模式固化

部署完 OpenCrew 后,Agent 间的协作(A2A)需要额外配置才能真正跑通。本版本将 CTO↔Builder 和 CTO↔Ops 实战中沉淀的闭环模式整理成文档和 workspace 补丁,用户只需发一段 prompt 给自己的 Agent 即可自动完成 A2A 设置。

✨ 新增

• A2A 跑通指南 (中文 + English):面向 Agent 的 To-Agent 设置文档

  • 最小必要配置变更(agentToAgent.allow / maxPingPongTurns)
  • CTO / Builder / CoS 的 AGENTS.md 追加模板
  • CoS→CTO、CTO→Builder 两条主路径的验证步骤
  • 5 个经实战验证的关键模式

• README 新增「跑通 A2A 闭环」section(中英双语)

  • 含 copy-paste prompt,发给任一 Agent 即可自动设置

🔧 更新(增量,未重写)

• shared/A2A_PROTOCOL.md — 融入 3 个 battle-tested 模式:

  • 多轮 WAIT 纪律 + Round0 审计握手
  • sessions_send timeout 容错 + sessionKey 大小写注意
  • 双通道留痕 + 闭环 DoD(4 步硬规则)

• workspaces/cto/AGENTS.md — A2A 派单扩展(thread 留痕 / checkpoint 同步 / timeout / 4步 DoD)

• workspaces/builder/AGENTS.md — 新增 A2A 协作 section(WAIT 纪律 / thread 留痕 / REPLY_SKIP)

📋 5 个实战模式

设计原则

• 所有 workspace 变更为 append-only(不重写已有内容)
• 面向 Agent 消费,最小化人工介入
• 经验来源:真实部署中 CTO↔Builder 和 CTO↔Ops 的多轮闭环实测

What's New / 更新内容

This release optimizes the English documentation to match the to-agent deployment flow introduced in v0.1.0, and adds an Agent-Ready Deployment badge to both READMEs.

本次更新将英文文档同步为 v0.1.0 引入的 To-Agent 部署流程,并在中英文 README 均添加了 Agent-Ready 标识。

Agent-Ready Deployment / To-Agent 友好部署

OpenCrew docs are now structured and battle-tested for autonomous agent execution. Your OpenClaw reads the repo and deploys for you — minimal manual steps required.

文档结构经真实部署实测优化,你的 OpenClaw 可直接阅读并自动完成部署——最少人工介入。

Changes / 变更

• 🤖 Agent-Ready badge added to both READMEs / 中英文 README 均添加 Agent-Ready 标识
• README.en.md: Get Started updated from bash commands to to-agent flow / 英文「快速上手」从手动命令改为对话式部署
• DEPLOY.en.md: Added structured "Execution Prompt for OpenClaw" (6 steps) / 新增结构化执行提示(6 步),Agent 可自主完成部署
• DEPLOY.en.md: Method A prompt aligned with Chinese version / 方式 A 的 prompt 与中文版对齐

Upgrade / 升级

cd <your-opencrew-repo>
git pull origin main

No config changes required — docs-only release. / 纯文档更新,无需修改配置。

主要变更

上手流程优化(本次新增)

• README「10 分钟上手」:从 3 步 bash 命令 → 3 步人话(建频道 → 发指令给 OpenClaw → 验证)
• DEPLOY.md:新增「给 OpenClaw 的执行提示」,让用户的 OpenClaw 能自动完成部署(含 Slack API 自动获取 Channel ID)
• 用户 prompt 从 12 行 6 步流程简化为自然语言

文档重构

• README 全面重构:痛点驱动开场、TOC、badges、FAQ、文档导航表
• 新增 4 份核心文档:完整上手指南、核心概念详解、Agent 入职指南、FAQ
• 架构文档精简,聚焦设计取舍
• 所有文档添加面包屑导航

修复

• README badge 链接、措辞修正
• SLACK_SETUP 移除本地路径暴露
• CUSTOMIZATION 修复命令错误

完整变更见 CHANGELOG.md

首次使用? 看 README 的「10 分钟上手」即可。