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