Yayın grupları

Genel Bakış

Yayın Grupları, birden fazla ajanın aynı iletiyi eş zamanlı olarak işlemesini ve yanıtlamasını sağlar. Bu, tek bir WhatsApp grubunda veya DM'de birlikte çalışan uzmanlaşmış ajan ekipleri oluşturmanıza olanak tanır — hepsi tek bir telefon numarasıyla.

Geçerli kapsam: yalnızca WhatsApp (web kanalı).

Yayın grupları, kanal izin listeleri ve grup etkinleştirme kurallarından sonra değerlendirilir. WhatsApp gruplarında bu, yayınların OpenClaw normalde yanıt vereceği durumda gerçekleştiği anlamına gelir (örneğin: grup ayarlarınıza bağlı olarak bahsedildiğinde).

Canlı WhatsApp QA hattı, bahsedilen tek bir grup iletisinin yapılandırılmış iki ajandan farklı görünür yanıtlar üretebildiğini doğrulayan whatsapp-broadcast-group-fanout içerir.

Kullanım alanları

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)

Yapılandırma

Temel kurulum

Üst düzey bir broadcast bölümü ekleyin (bindings yanında). Anahtarlar WhatsApp eş id'leridir:

• grup sohbetleri: grup JID'si (örn. 120363403215116621@g.us)
• DM'ler: E.164 telefon numarası (örn. +15551234567)

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

Sonuç: OpenClaw bu sohbette yanıt vereceği zaman, üç ajanın tamamını çalıştırır.

İşleme stratejisi

Ajanların iletileri nasıl işleyeceğini denetleyin:

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

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

Tam örnek

{  "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"]  }}

Nasıl çalışır

İleti akışı

Oturum yalıtımı

Bir yayın grubundaki her ajan tamamen ayrı şunları korur:

• Oturum anahtarları (agent:alfred:whatsapp:group:120363... ile agent:baerbel:whatsapp:group:120363... karşılaştırması)
• Konuşma geçmişi (ajan diğer ajanların iletilerini görmez)
• Çalışma alanı (yapılandırılmışsa ayrı sandbox'lar)
• Araç erişimi (farklı izin/verme listeleri)
• Bellek/bağlam (ayrı IDENTITY.md, SOUL.md, vb.)
• Grup bağlam arabelleği (bağlam için kullanılan son grup iletileri) eş başına paylaşılır; bu nedenle tüm yayın ajanları tetiklendiğinde aynı bağlamı görür

Bu, her ajanın şunlara sahip olmasını sağlar:

• Farklı kişilikler
• Farklı araç erişimi (örn. salt okunur ile okuma-yazma)
• Farklı modeller (örn. opus ile sonnet)
• Yüklü farklı Skills

Örnek: yalıtılmış oturumlar

120363403215116621@g.us grubunda ["alfred", "baerbel"] ajanlarıyla:

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

En iyi uygulamalar

{  "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

Uyumluluk

Sağlayıcılar

Yayın grupları şu anda şunlarla çalışır:

• ✅ WhatsApp (uygulandı)
• 🚧 Telegram (planlandı)
• 🚧 Discord (planlandı)
• 🚧 Slack (planlandı)

Yönlendirme

Yayın grupları mevcut yönlendirmeyle birlikte çalışır:

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

• GROUP_A: Yalnızca alfred yanıt verir (normal yönlendirme).
• GROUP_B: agent1 VE agent2 yanıt verir (yayın).

Sorun giderme

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

Örnekler

{  "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" }    ]  }}

API başvurusu

Yapılandırma şeması

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

Alanlar

Sınırlamalar

1. Maksimum agent sayısı: Kesin bir sınır yoktur, ancak 10+ agent yavaş olabilir.
2. Paylaşılan bağlam: Agentler birbirlerinin yanıtlarını görmez (tasarım gereği).
3. Mesaj sıralaması: Paralel yanıtlar herhangi bir sırada gelebilir.
4. Hız sınırları: Tüm agentler WhatsApp hız sınırlarına dahil edilir.

Gelecekteki iyileştirmeler

Planlanan özellikler:

• [ ] Paylaşılan bağlam modu (agentler birbirlerinin yanıtlarını görür)
• [ ] Agent koordinasyonu (agentler birbirlerine sinyal gönderebilir)
• [ ] Dinamik agent seçimi (mesaj içeriğine göre agentleri seçin)
• [ ] Agent öncelikleri (bazı agentler diğerlerinden önce yanıt verir)

İlgili

• Kanal yönlendirme
• Gruplar
• Çok agentli sandbox araçları
• Eşleştirme
• Oturum yönetimi