Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Status: Eksperimental. Ditambahkan pada 2026.1.9.

​
Gambaran umum

Grup Broadcast memungkinkan beberapa agen memproses dan merespons pesan yang sama secara bersamaan. Ini memungkinkan Anda membuat tim agen terspesialisasi 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 daftar izin 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).

​
Kasus penggunaan

Terapkan 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 terspesialisasinya.
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 sebelah bindings). Kunci 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

Kontrol 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

Pesan masuk tiba

Pesan grup WhatsApp atau DM tiba.
2

Pemeriksaan broadcast

Sistem memeriksa apakah ID peer ada di broadcast.
3

Jika ada dalam daftar broadcast

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

Jika tidak ada dalam daftar broadcast

Perutean normal berlaku (binding pertama yang cocok).
Grup broadcast tidak melewati daftar izin kanal atau aturan aktivasi grup (sebutan/perintah/dll). Grup broadcast 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 alat (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 berbeda
  • Akses alat berbeda (mis., hanya-baca vs. baca-tulis)
  • Model berbeda (mis., opus vs. sonnet)
  • Skills berbeda yang terinstal

​
Contoh: sesi terisolasi

Di 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”.
Buat jelas apa yang dilakukan setiap agen:
{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}
Berikan agen hanya alat yang mereka perlukan:
{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}
reviewer bersifat 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. Kesalahan 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 berfungsi dengan:
  • ✅ WhatsApp (diimplementasikan)
  • 🚧 Telegram (direncanakan)
  • 🚧 Discord (direncanakan)
  • 🚧 Slack (direncanakan)

​
Perutean

Grup broadcast bekerja 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 (broadcast).
Prioritas: broadcast memiliki prioritas lebih tinggi daripada bindings.

​
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 bindings tetapi tidak di broadcast.Perbaikan: Tambahkan ke konfigurasi broadcast atau hapus dari bindings.
Jika lambat dengan banyak agen:
  • Kurangi jumlah agen per grup.
  • Gunakan model yang lebih ringan (sonnet alih-alih opus).
  • Periksa waktu startup 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: “Memperbaiki indentasi dan menambahkan petunjuk tipe”
  • security-scanner: “⚠️ Kerentanan injeksi SQL di baris 12”
  • test-coverage: “Cakupan 45%, kurang pengujian untuk kasus kesalahan”
  • docs-checker: “Docstring hilang untuk fungsi 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 lain. Nilainya adalah array ID agen yang harus memproses pesan.

​
Batasan

  1. Maks agen: 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.

​
Peningkatan mendatang

Fitur yang direncanakan:
  • Mode konteks bersama (agen melihat respons satu sama lain)
  • Koordinasi agen (agen dapat memberi sinyal satu sama lain)
  • Pemilihan agen dinamis (memilih agen berdasarkan konten pesan)
  • Prioritas agen (beberapa agen merespons sebelum yang lain)

​
Terkait