Grup siaran

# 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

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 sebelah bindings). Kunci adalah ID peer WhatsApp:

• chat grup: JID grup (mis. [email protected])
• DM: nomor telepon E.164 (mis. +15551234567)

{
  "broadcast": {
    "[email protected]": ["alfred", "baerbel", "assistant3"]
  }
}

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

# Strategi pemrosesan

Kontrol cara agen memproses pesan:

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": ["alfred", "baerbel"]
  }
}

{
  "broadcast": {
    "strategy": "sequential",
    "[email protected]": ["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",
    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],
    "[email protected]": ["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 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 [email protected] dengan agen ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:[email protected]
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:[email protected]
History: [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 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).

# Pemecahan masalah

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

# Contoh

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": [
      "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. 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

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