Grup siaran

Ikhtisar

Grup siaran menjalankan beberapa agen pada pesan masuk yang sama. Setiap agen memproses pesan dalam sesinya sendiri yang terisolasi dan mengirimkan balasannya sendiri, sehingga satu nomor WhatsApp dapat menampung tim agen khusus dalam satu obrolan grup atau DM.

Grup siaran dievaluasi setelah daftar izin kanal dan aturan aktivasi grup. Dalam grup WhatsApp, siaran terjadi ketika OpenClaw biasanya akan membalas (misalnya: saat disebut, bergantung pada pengaturan grup Anda). Grup siaran hanya mengubah agen mana yang dijalankan, bukan menentukan apakah pesan memenuhi syarat untuk diproses.

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

Konfigurasi

Penyiapan dasar

Tambahkan bagian broadcast pada tingkat teratas (di sebelah bindings). Kuncinya adalah ID rekan WhatsApp dan nilainya adalah larik ID agen:

• obrolan grup: JID grup (misalnya 120363403215116621@g.us)
• DM: nomor telepon pengirim dalam format E.164 (misalnya +15551234567)

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

Hasil: ketika OpenClaw biasanya akan membalas dalam obrolan ini, OpenClaw menjalankan ketiga agen tersebut.

Setiap ID agen yang dicantumkan harus ada di agents.list: validasi konfigurasi melaporkan ID yang tidak dikenal, dan runtime melewatinya dengan peringatan Broadcast agent <id> not found in agents.list; skipping.

Strategi pemrosesan

broadcast.strategy menentukan cara agen memproses pesan:

{  "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 siaran memiliki komponen berikut yang sepenuhnya terpisah:

• Kunci sesi (agent:alfred:whatsapp:group:120363... dibandingkan dengan agent:baerbel:whatsapp:group:120363...)
• Riwayat percakapan (agen tidak melihat balasan agen lain)
• Ruang kerja (sandbox terpisah jika dikonfigurasi)
• Akses alat (daftar izin/tolak yang berbeda)
• Memori/konteks (IDENTITY.md, SOUL.md, dan sebagainya yang terpisah)

Ada satu pengecualian yang sengaja dibagikan: buffer konteks grup (pesan grup terbaru yang digunakan sebagai konteks) dibagikan per rekan, sehingga semua agen siaran melihat konteks yang sama saat dipicu. Buffer ini dikosongkan satu kali setelah penyebaran selesai.

Hal ini memungkinkan setiap agen memiliki kepribadian, model, Skills, dan akses alat yang berbeda (misalnya hanya baca dibandingkan baca-tulis).

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: ~/openclaw-alfred/Tools: read, write, exec

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

Kasus penggunaan

• Tim agen khusus: grup pengembangan tempat code-reviewer, security-auditor, test-generator, dan docs-checker masing-masing menjawab pesan yang sama dari sudut pandangnya sendiri.
• Dukungan multibahasa: satu obrolan dukungan dengan support-en, support-de, dan support-es yang merespons dalam bahasa masing-masing.
• Jaminan kualitas: support-agent menjawab sementara qa-agent meninjau dan hanya merespons ketika menemukan masalah.
• Otomatisasi tugas: task-tracker, time-logger, dan report-generator semuanya menggunakan pembaruan status yang sama.

Praktik terbaik

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

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

Kompatibilitas

Penyedia

Grup siaran saat ini hanya diterapkan untuk WhatsApp (kanal web). Kanal lain mengabaikan konfigurasi broadcast.

Perutean

Grup siaran berfungsi bersama 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 (siaran).

Pemecahan masalah

openclaw logs --follow | grep -i 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

Keterbatasan

1. Jumlah maksimum agen: tidak ada batas tegas, tetapi banyak agen (10+) dapat berjalan lambat.
2. Konteks bersama: agen tidak melihat respons satu sama lain (sesuai rancangan).
3. Urutan pesan: respons paralel dapat tiba dalam urutan apa pun.
4. Batas laju: semua balasan berasal dari satu akun WhatsApp, sehingga balasan setiap agen dihitung terhadap batas laju WhatsApp yang sama.

Terkait

• Perutean channel
• Grup
• Alat sandbox multiagen
• Pemasangan
• Manajemen sesi