Agent Collaboration Protocol

A complete protocol layer for building structured, multi-agent systems.
Provides the rules, templates, and operational procedures to ensure agents work together consistently.

What's Included

Quick Start

Install from ClawHub

npx clawhub install agent-collab-protocol

Or use locally

# Protocol files are in: skill/agent-collab-protocol/references/
# Copy to your protocol directory:
cp -r skill/agent-collab-protocol/references/ ~/.openclaw/protocol/

Create a new business domain

cd ~/.openclaw/protocol
bash scaffold-domain.sh fintech 金融产品经理 "fintech-analyzer:金融分析师"

Architecture Overview

Layer 0 (Orchestrator)          Identify domain → dispatch to Manager → verify
    ↓ (natural language)
Layer 1 (Manager)               Understand → decompose → dispatch → aggregate
    ↓ (JSON Task Package)
Layer 2 (Specialist)            Execute → deliver via \x3Cagent-response>

Key Protocol Rules

• L0 dispatches to L1 Managers via natural language
• L1 decomposes tasks into JSON Task packages for L2 Specialists
• L2 executes and returns \x3Cagent-response> blocks
• Tasks that fail: retry 1 time → downgrade → report as partial/failed
• 3-layer maximum depth (L0 → L1 → L2)

Usage

For Framework Authors

Reference AGENT_COLLAB_PROTOCOL.md to implement protocol compliance in your agent runtime.

For Agent Developers

1. Copy the relevant TEMPLATE_*.md files
2. Fill in your agent's business-specific content
3. Register in your domain configuration
4. Follow NEW_AGENT_CHECKLIST.md for new agents

For Team Leads

Use NEW_AGENT_CHECKLIST.md as a mandatory gating process — each team member must check off all 8 steps before a new agent is considered complete.

Files

agent-collab-protocol/
├── SKILL.md                       ← This file
├── _meta.json                     ← Package metadata
└── references/
    ├── AGENT_COLLAB_PROTOCOL.md   ← Core protocol (413 lines)
    ├── OPERATIONS.md              ← Operational guide
    ├── NEW_AGENT_CHECKLIST.md     ← Mandatory checklist (156 lines, 64 checks)
    ├── TEMPLATE_AGENTS.md         ← AGENTS.md template
    ├── TEMPLATE_IDENTITY.md       ← Identity card template
    ├── TEMPLATE_SOUL.md           ← Values & red lines template
    ├── TEMPLATE_USER.md           ← Service object template
    └── scaffold-domain.sh         ← Domain scaffolding script

Changelog