Langsung ke konten utama
Status: Eksperimental. Ditambahkan pada 2026.1.9.

​
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

Jalankan beberapa agen dengan tanggung jawab yang atomik dan terfokus:
Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)
Setiap agen memproses pesan yang sama dan memberikan perspektif khususnya.
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:
Semua agen memproses secara bersamaan:
{
  "broadcast": {
    "strategy": "parallel",
    "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

1

Incoming message arrives

Pesan grup WhatsApp atau DM masuk.
2

Route and admission

OpenClaw menerapkan allowlist kanal, aturan aktivasi grup, dan kepemilikan binding ACP yang dikonfigurasi.
3

Broadcast check

Jika tidak ada binding ACP yang dikonfigurasi yang memiliki rute tersebut, OpenClaw memeriksa apakah ID peer ada di broadcast.
4

If broadcast applies

  • Semua agen yang tercantum memproses pesan.
  • Setiap agen memiliki kunci sesi dan konteks terisolasi sendiri.
  • Agen memproses secara paralel (default) atau berurutan.
5

If broadcast does not apply

OpenClaw mengirim rute biasa atau rute sesi ACP yang dikonfigurasi yang dipilih selama perutean.
Grup broadcast tidak melewati allowlist kanal atau aturan aktivasi grup (sebutan/perintah/dll). Grup ini hanya mengubah agen mana yang berjalan ketika sebuah pesan memenuhi syarat untuk diproses.

​
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.us
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

​
Praktik terbaik

Rancang setiap agen dengan satu tanggung jawab yang jelas:
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
✅ Baik: Setiap agen memiliki satu tugas. ❌ Buruk: Satu agen generik “dev-helper”.
Perjelas apa yang dilakukan setiap agen:
{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}
Berikan agen hanya tool yang mereka perlukan:
{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}
reviewer hanya-baca. fixer dapat membaca dan menulis.
Dengan banyak agen, pertimbangkan:
  • Menggunakan "strategy": "parallel" (default) untuk kecepatan
  • Membatasi grup broadcast hingga 5-10 agen
  • Menggunakan model yang lebih cepat untuk agen yang lebih sederhana
Agen gagal secara independen. Error satu agen tidak memblokir agen lain:
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).
Prioritas: broadcast diprioritaskan dibanding binding rute biasa. Binding ACP yang dikonfigurasi (bindings[].type="acp") bersifat eksklusif: ketika salah satunya cocok, OpenClaw mengirim ke sesi ACP yang dikonfigurasi alih-alih broadcast fan-out.

​
Pemecahan masalah

Periksa:
  1. ID agen ada di agents.list.
  2. Format ID peer benar (mis. 120363403215116621@g.us).
  3. Agen tidak ada dalam daftar tolak.
Debug:
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
Penyebab: ID peer mungkin ada di binding rute biasa tetapi tidak di broadcast, atau mungkin cocok dengan binding ACP eksklusif yang dikonfigurasi.Perbaikan: Tambahkan peer yang terikat rute biasa ke konfigurasi broadcast, atau hapus/ubah binding ACP yang dikonfigurasi jika broadcast fan-out diinginkan.
Jika lambat dengan banyak agen:
  • Kurangi jumlah agen per grup.
  • Gunakan model yang lebih ringan (sonnet alih-alih opus).
  • Periksa waktu mulai sandbox.

​
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"] } }
    ]
  }
}
Pengguna mengirim: Cuplikan kode.Respons:
  • code-formatter: “Fixed indentation and added type hints”
  • security-scanner: “⚠️ SQL injection vulnerability in line 12”
  • test-coverage: “Coverage is 45%, missing tests for error cases”
  • docs-checker: “Missing docstring for function process_data”
{
  "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

​
strategy
"parallel" | "sequential"
default:"\"parallel\""
Cara memproses agen. parallel menjalankan semua agen secara bersamaan; sequential menjalankannya sesuai urutan array.
​
[peerId]
string[]
JID grup WhatsApp, nomor E.164, atau ID peer lainnya. Nilainya adalah array ID agen yang harus memproses pesan.

​
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