v0.3.0 — A2A v2: Agent 间真正的协作

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

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

核心变化

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

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

  

_{左：架构——编排者（独立 App）进入执行 Agent 频道协作  |  右：实战——两个 Agent 在 #ops 协作排查问题（全程无人干预）}

新增功能

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 顺序、热重载、回滚方式
• 实战验证步骤

平台支持

能力	Slack	Discord	飞书
Delegation（sessions_send）	✅	✅	✅
Discussion（跨 bot 对话）	✅ 已验证	❌ OpenClaw 代码层 bug	❌ 飞书平台限制
Thread / Topic 隔离	✅ 原生	✅ 自动归档	✅ groupSessionScope (>= 2026.3.1)

• 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.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 模式一览

平台	默认	进阶选项
Slack	单 Bot 共享身份	—
飞书	单 Bot 共享身份	✅ 独立 Bot（多应用模式）
Discord	单 Bot 共享身份	✅ Webhook Relay 或 独立 Bot

设计原则

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

---

完整变更记录见 CHANGELOG.md

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

🚀 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 版）

⚠️ 已知限制

平台	Thread 隔离	说明
Slack	✅ 支持	channel = 岗位，thread = 任务
Discord	✅ 支持	thread 继承 parent channel 配置
飞书	❌ 暂不支持	OpenClaw 飞书插件限制（Issue #10242），同群对话平铺

---

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

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

🚀 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 个实战模式

模式	说明
Round0 审计握手	正式工作前先验证 Slack 可见性
多轮 WAIT 纪律	每轮 1-2 改动 → Done/Run/Output/WAIT → 等上游指令
Timeout 容错	sessions_send timeout ≠ 失败，需 thread 兜底消息
闭环 DoD	Builder closeout → 上游本机复核 → 回发起频道汇报
SessionKey 注意	不手打；注意大小写一致性

设计原则

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

v0.1.1 — Agent-Ready Deployment

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. / 纯文档更新，无需修改配置。

v0.1.0 — 文档重构 + 上手流程优化

主要变更

上手流程优化（本次新增）

• 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 分钟上手」即可。