Grup siaran

Gambaran umum

Broadcast Groups memungkinkan beberapa agen memproses dan merespons pesan yang sama secara bersamaan. Ini memungkinkan Anda membuat tim agen khusus yang bekerja bersama dalam satu grup WhatsApp atau DM — semuanya menggunakan satu nomor telepon.

Cakupan saat ini: hanya WhatsApp (kanal web).

Grup broadcast dievaluasi setelah allowlist kanal dan aturan aktivasi grup. Di grup WhatsApp, ini berarti broadcast terjadi ketika OpenClaw biasanya akan membalas (misalnya: saat disebut, bergantung pada pengaturan grup Anda).

Lane QA WhatsApp langsung menyertakan whatsapp-broadcast-group-fanout, yang memverifikasi bahwa satu pesan grup yang menyebut OpenClaw dapat menghasilkan balasan terlihat yang berbeda dari dua agen yang dikonfigurasi.

Kasus penggunaan

Group: "Development Team"Agents:  - CodeReviewer (reviews code snippets)  - DocumentationBot (generates docs)  - SecurityAuditor (checks for vulnerabilities)  - TestGenerator (suggests test cases)

Group: "International Support"Agents:  - Agent_EN (responds in English)  - Agent_DE (responds in German)  - Agent_ES (responds in Spanish)

Group: "Customer Support"Agents:  - SupportAgent (provides answer)  - QAAgent (reviews quality, only responds if issues found)

Group: "Project Management"Agents:  - TaskTracker (updates task database)  - TimeLogger (logs time spent)  - ReportGenerator (creates summaries)

Konfigurasi

Penyiapan dasar

Tambahkan bagian broadcast tingkat atas (di samping bindings). Kuncinya adalah ID peer WhatsApp:

• chat grup: JID grup (mis. 120363403215116621@g.us)
• DM: nomor telepon E.164 (mis. +15551234567)

{  "broadcast": {    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]  }}

Hasil: Ketika OpenClaw akan membalas di chat ini, OpenClaw akan menjalankan ketiga agen.

Strategi pemrosesan

Kendalikan cara agen memproses pesan:

{  "broadcast": {    "strategy": "parallel",    "120363403215116621@g.us": ["alfred", "baerbel"]  }}

{  "broadcast": {    "strategy": "sequential",    "120363403215116621@g.us": ["alfred", "baerbel"]  }}

Contoh lengkap

{  "agents": {    "list": [      {        "id": "code-reviewer",        "name": "Code Reviewer",        "workspace": "/path/to/code-reviewer",        "sandbox": { "mode": "all" }      },      {        "id": "security-auditor",        "name": "Security Auditor",        "workspace": "/path/to/security-auditor",        "sandbox": { "mode": "all" }      },      {        "id": "docs-generator",        "name": "Documentation Generator",        "workspace": "/path/to/docs-generator",        "sandbox": { "mode": "all" }      }    ]  },  "broadcast": {    "strategy": "parallel",    "120363403215116621@g.us": ["code-reviewer", "security-auditor", "docs-generator"],    "120363424282127706@g.us": ["support-en", "support-de"],    "+15555550123": ["assistant", "logger"]  }}

Cara kerjanya

Alur pesan

Isolasi sesi

Setiap agen dalam grup broadcast mempertahankan hal-hal yang sepenuhnya terpisah:

• Kunci sesi (agent:alfred:whatsapp:group:120363... vs agent:baerbel:whatsapp:group:120363...)
• Riwayat percakapan (agen tidak melihat pesan agen lain)
• Workspace (sandbox terpisah jika dikonfigurasi)
• Akses tool (daftar izinkan/tolak yang berbeda)
• Memori/konteks (IDENTITY.md, SOUL.md, dll. terpisah)
• Buffer konteks grup (pesan grup terbaru yang digunakan untuk konteks) dibagikan per peer, sehingga semua agen broadcast melihat konteks yang sama saat dipicu

Ini memungkinkan setiap agen memiliki:

• Kepribadian yang berbeda
• Akses tool yang berbeda (mis. hanya baca vs. baca-tulis)
• Model yang berbeda (mis. opus vs. sonnet)
• Skills berbeda yang terinstal

Contoh: sesi terisolasi

Dalam grup 120363403215116621@g.us dengan agen ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: /Users/user/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: /Users/user/openclaw-baerbel/Tools: read only

Praktik terbaik

{  "broadcast": {    "DEV_GROUP": ["formatter", "linter", "tester"]  }}

{  "agents": {    "security-scanner": { "name": "Security Scanner" },    "code-formatter": { "name": "Code Formatter" },    "test-generator": { "name": "Test Generator" }  }}

{  "agents": {    "reviewer": {      "tools": { "allow": ["read", "exec"] }    },    "fixer": {      "tools": { "allow": ["read", "write", "edit", "exec"] }    }  }}

Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]Result: Agent A and C respond, Agent B logs error

Kompatibilitas

Penyedia

Grup broadcast saat ini bekerja dengan:

• ✅ WhatsApp (diimplementasikan)
• 🚧 Telegram (direncanakan)
• 🚧 Discord (direncanakan)
• 🚧 Slack (direncanakan)

Perutean

Grup broadcast bekerja berdampingan dengan perutean yang sudah ada:

{  "bindings": [    {      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },      "agentId": "alfred"    }  ],  "broadcast": {    "GROUP_B": ["agent1", "agent2"]  }}

• GROUP_A: Hanya alfred yang merespons (perutean normal).
• GROUP_B: agent1 DAN agent2 merespons (broadcast).

Pemecahan masalah

tail -f ~/.openclaw/logs/gateway.log | grep broadcast

Contoh

{  "broadcast": {    "strategy": "parallel",    "120363403215116621@g.us": [      "code-formatter",      "security-scanner",      "test-coverage",      "docs-checker"    ]  },  "agents": {    "list": [      {        "id": "code-formatter",        "workspace": "~/agents/formatter",        "tools": { "allow": ["read", "write"] }      },      {        "id": "security-scanner",        "workspace": "~/agents/security",        "tools": { "allow": ["read", "exec"] }      },      {        "id": "test-coverage",        "workspace": "~/agents/testing",        "tools": { "allow": ["read", "exec"] }      },      { "id": "docs-checker", "workspace": "~/agents/docs", "tools": { "allow": ["read"] } }    ]  }}

{  "broadcast": {    "strategy": "sequential",    "+15555550123": ["detect-language", "translator-en", "translator-de"]  },  "agents": {    "list": [      { "id": "detect-language", "workspace": "~/agents/lang-detect" },      { "id": "translator-en", "workspace": "~/agents/translate-en" },      { "id": "translator-de", "workspace": "~/agents/translate-de" }    ]  }}

Referensi API

Skema konfigurasi

interface OpenClawConfig {  broadcast?: {    strategy?: "parallel" | "sequential";    [peerId: string]: string[];  };}

Bidang

Batasan

1. Agen maksimum: Tidak ada batas keras, tetapi 10+ agen mungkin lambat.
2. Konteks bersama: Agen tidak melihat respons satu sama lain (sesuai desain).
3. Urutan pesan: Respons paralel dapat tiba dalam urutan apa pun.
4. Batas laju: Semua agen dihitung terhadap batas laju WhatsApp.

Penyempurnaan mendatang

Fitur yang direncanakan:

• [ ] Mode konteks bersama (agen melihat respons satu sama lain)
• [ ] Koordinasi agen (agen dapat saling memberi sinyal)
• [ ] Pemilihan agen dinamis (memilih agen berdasarkan isi pesan)
• [ ] Prioritas agen (beberapa agen merespons sebelum yang lain)

Terkait

• Perutean channel
• Grup
• Alat sandbox multi-agen
• Penyandingan
• Manajemen sesi