Skip to content

feat: A2A v2 research, architecture design & doc fixes (#31, #33, #34)#36

Open
AlexAnys wants to merge 1 commit intomainfrom
feat/a2a-v2-research-and-doc-fixes
Open

feat: A2A v2 research, architecture design & doc fixes (#31, #33, #34)#36
AlexAnys wants to merge 1 commit intomainfrom
feat/a2a-v2-research-and-doc-fixes

Conversation

@AlexAnys
Copy link
Copy Markdown
Owner

@AlexAnys AlexAnys commented Mar 28, 2026

Summary

Multi-agent harness research and architecture design for evolving OpenCrew's A2A from "delegation-only" to "true multi-agent collaboration," plus documentation fixes for issues #31, #33, and #34.

Documentation Fixes (Commit 1 — user-facing)

  • Discord (路由bug,cos和ops对话混合到了一起 #34): Add Step 5b channel permission isolation to prevent routing bug where cos/ops conversations mix
  • Discord: Update PR #3672 status from "in development" to "merged January 2026"
  • Feishu (飞书官方插件支持多agent一一对应bot路由了! #31): Document groupSessionScope: "group_topic" for per-topic session isolation
  • Feishu: Add SecretRef bug caveat (openclaw #47436) in multi-app section
  • Getting Started (支持作者(催更) #33): Fix deployment order (bot creation → THEN OpenClaw connection), add prerequisites checklist, common mistakes section
  • Known Issues: Add Feishu session isolation as resolved P1, fix broken anchor link
  • All changes in both Chinese and English versions (8 files, +313 lines)

A2A v2 Research & Architecture (Commit 2 — harness artifacts)

Phase 1 — Research (3 parallel agents):

  • Slack: True multi-agent collaboration achievable NOW via allowBots + requireMention + multi-account. Self-loop filter is per-bot-user-ID → naturally bypassed.
  • Feishu: groupSessionScope: "group_topic" solves P0 session sharing. But bot messages DON'T trigger other bots (platform limitation) → sessions_send still required.
  • Discord: Platform supports cross-bot visibility, but OpenClaw bug #11199 blocks it. Once fixed → similar to Slack.

Phase 2 — Architecture (2 parallel agents):

  • A2A v2 Protocol: Dual-mode design — Delegation (v1, sessions_send) + Discussion (v2, @mention) coexist
  • 5 Collaboration Patterns: Architecture Review, Strategic Alignment, Code/Design Review, Incident Response, Knowledge Synthesis
  • 3-Level Orchestration: Human → Agent → Event-Driven (phased rollout)
  • Platform Matrix: Slack (NOW) > Discord (AFTER #11199) > Feishu (Delegation ONLY)
  • 6 ADRs grounded in research findings

Phase 3 — QA Verification:

  • Independent QA agent verified all outputs → 5 documentation-level issues found and fixed → PASS

Key Architectural Insight

The "true A2A" value from harness design methodology:

  • Current: Agent A sends task to Agent B → B executes → B reports back (delegation)
  • New: Multiple agents participate in same Slack thread, each bringing domain judgment (collaboration)
  • Slack thread = "Live Blackboard" — real-time version of harness file-based communication

Files

Category Files Lines
Doc fixes (CN+EN) 8 +313
Research reports 3 ~1,100
Architecture reports 2 ~1,950
QA report 1 ~254
Agent definitions 4 ~400
Harness config 6 ~150
CLAUDE.md 1 ~80
Total 25 ~4,247

Test plan

  • Review doc fixes: deployment order in Getting Started makes logical sense
  • Review Discord Step 5b: permission isolation instructions are actionable
  • Review Feishu groupSessionScope section: config example is correct
  • Review A2A v2 protocol: Delegation (v1) backward compatibility preserved
  • Review collaboration patterns: mechanically described, not just conceptual
  • Review platform matrix consistency across all documents
  • Verify CN and EN docs match in structure

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7e825263db

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

```yaml
channels:
feishu:
groupSessionScope: “group_topic”
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use ASCII quotes in Feishu YAML example

The YAML snippet here uses typographic quotes (“group_topic”) instead of plain ASCII quotes, so users who copy this config will end up with invalid YAML (or a value that OpenClaw cannot parse as intended) when enabling groupSessionScope. Because this section is the documented resolution path for the Feishu isolation issue, the snippet should use standard "group_topic" to avoid setup failures.

Useful? React with 👍 / 👎.

…, #34)

Address user-reported issues and integrate new platform capabilities:

Discord (Issue #34 — routing bug):
- Add Step 5b: channel permission isolation to prevent agent
  conversation mixing (single-bot and multi-bot approaches)
- Update multi-account support status (available in current versions)

Feishu (Issue #31 — multi-agent support):
- Document groupSessionScope: "group_topic" for per-topic session
  isolation (OpenClaw >= 2026.3.1), shown as incremental config patch
- Add CLI alternative: openclaw config set
- Add SecretRef bug caveat (openclaw #47436) in multi-app section
- Fix issue citation: #10242 (DM threads) → #29791 (group chat topics)

Getting Started (Issue #33 — beginner experience):
- Fix deployment order with clear "Manual" vs "Agent-automated" labels
- Note that steps 5-9 can be fully automated via DEPLOY.md
- Add prerequisites checklist covering all platforms
- Add common mistakes section (5 items)

Known Issues:
- Add Feishu P1 (resolved) entry with groupSessionScope resolution
- Fix typographic quotes in YAML examples (would cause parse failures)

All changes in both Chinese and English versions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@AlexAnys AlexAnys force-pushed the feat/a2a-v2-research-and-doc-fixes branch from 61c23c0 to 6e82fe8 Compare March 29, 2026 00:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant