Yayın grupları

Genel bakış

Yayın grupları, aynı gelen ileti için birden fazla agent çalıştırır. Her agent iletiyi kendi yalıtılmış oturumunda işler ve kendi yanıtını gönderir; böylece tek bir WhatsApp numarası, tek bir grup sohbetinde veya doğrudan mesajda uzmanlaşmış agent'lardan oluşan bir ekibi barındırabilir.

Yayın grupları, kanal izin listeleri ve grup etkinleştirme kurallarından sonra değerlendirilir. WhatsApp gruplarında yayınlar, OpenClaw normalde yanıt vereceği zaman gerçekleşir (örneğin grup ayarlarınıza bağlı olarak bahsedildiğinde). Yalnızca hangi agent'ların çalışacağını değiştirirler; bir iletinin işlenmeye uygun olup olmadığını hiçbir zaman değiştirmezler.

Canlı WhatsApp kalite güvencesi hattı, bahsetme içeren tek bir grup iletisinin yapılandırılmış iki agent'dan farklı ve görünür yanıtlar üretebildiğini doğrulayan whatsapp-broadcast-group-fanout senaryosunu içerir.

Yapılandırma

Temel kurulum

Üst düzey bir broadcast bölümü (bindings ile aynı düzeyde) ekleyin. Anahtarlar WhatsApp eş kimlikleri, değerler ise agent kimliği dizileridir:

• grup sohbetleri: grup JID'si (ör. 120363403215116621@g.us)
• doğrudan mesajlar: gönderenin E.164 telefon numarası (ör. +15551234567)

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

Sonuç: OpenClaw bu sohbette yanıt vereceği zaman üç agent'ı da çalıştırır.

Listelenen her agent kimliği agents.list içinde bulunmalıdır: yapılandırma doğrulaması bilinmeyen kimlikleri bildirir ve çalışma zamanı bunları Broadcast agent <id> not found in agents.list; skipping uyarısıyla atlar.

İşleme stratejisi

broadcast.strategy, agent'ların iletiyi nasıl işleyeceğini belirler:

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

Eksiksiz ö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 agent aşağıdakileri tamamen ayrı tutar:

• Oturum anahtarları (agent:alfred:whatsapp:group:120363... ile agent:baerbel:whatsapp:group:120363...)
• Konuşma geçmişi (bir agent diğer agent'ların yanıtlarını görmez)
• Çalışma alanı (yapılandırılmışsa ayrı korumalı alanlar)
• Araç erişimi (farklı izin/verme listeleri)
• Bellek/bağlam (ayrı IDENTITY.md, SOUL.md vb.)

Bir istisna kasıtlı olarak paylaşılır: grup bağlam arabelleği (bağlam için kullanılan son grup iletileri) eş başına paylaşılır; böylece tüm yayın agent'ları tetiklendiklerinde aynı bağlamı görür. Dağıtım tamamlandıktan sonra bir kez temizlenir.

Bu, her agent'ın farklı kişiliklere, modellere, becerilere ve araç erişimine (örneğin salt okunur veya okuma-yazma) sahip olmasını sağlar.

Örnek: yalıtılmış oturumlar

["alfred", "baerbel"] agent'larının bulunduğu 120363403215116621@g.us grubunda:

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

Kullanım alanları

• Uzmanlaşmış agent ekipleri: code-reviewer, security-auditor, test-generator ve docs-checker agent'larının aynı iletiyi kendi bakış açılarından yanıtladığı bir geliştirme grubu.
• Çok dilli destek: support-en, support-de ve support-es agent'larının kendi dillerinde yanıt verdiği tek bir destek sohbeti.
• Kalite güvencesi: support-agent yanıt verirken qa-agent inceleme yapar ve yalnızca sorun bulduğunda yanıt verir.
• Görev otomasyonu: task-tracker, time-logger ve report-generator agent'larının tümü aynı durum güncellemesini işler.

En iyi uygulamalar

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

Uyumluluk

Sağlayıcılar

Yayın grupları şu anda yalnızca WhatsApp (web kanalı) için uygulanmıştır. Diğer kanallar broadcast yapılandırmasını yok sayar.

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

openclaw logs --follow | grep -i 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. En fazla agent sayısı: kesin bir sınır yoktur ancak çok sayıda agent (10+) yavaş olabilir.
2. Paylaşılan bağlam: agent'lar birbirlerinin yanıtlarını görmez (tasarım gereği).
3. İleti sıralaması: paralel yanıtlar herhangi bir sırada gelebilir.
4. Hız sınırları: tüm yanıtlar tek bir WhatsApp hesabından gelir; bu nedenle her agent'ın yanıtı aynı WhatsApp hız sınırlarına dâhil edilir.

İlgili

• Kanal yönlendirme
• Gruplar
• Çok aracılı korumalı alan araçları
• Eşleştirme
• Oturum yönetimi