Yayın Grupları
Durum: DeneyselSürüm: 2026.1.9 sürümünde eklendi
Genel Bakış
Yayın Grupları, birden fazla agentin aynı mesajı eşzamanlı olarak işlemesini ve yanıtlamasını sağlar. Bu, tek bir WhatsApp grubu veya DM içinde birlikte çalışan uzmanlaşmış agent ekipleri oluşturmanıza olanak tanır — üstelik hepsi tek bir telefon numarası kullanır. 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, OpenClaw’ın normalde yanıt vereceği durumlarda yayınların gerçekleştiği anlamına gelir (örneğin: grup ayarlarınıza bağlı olarak bir bahsetme olduğunda).Kullanım Durumları
1. Uzmanlaşmış Agent Ekipleri
Atomik ve odaklı sorumluluklara sahip birden fazla agent dağıtın:2. Çok Dilli Destek
3. Kalite Güvencesi İş Akışları
4. Görev Otomasyonu
Yapılandırma
Temel Kurulum
Üst düzey birbroadcast bölümü ekleyin (bindings ile aynı seviyede). Anahtarlar WhatsApp eş kimlikleridir:
- grup sohbetleri: grup JID’si (ör.
120363403215116621@g.us) - DM’ler: E.164 telefon numarası (ör.
+15551234567)
İşleme Stratejisi
Agentlerin mesajları nasıl işleyeceğini kontrol edin:Paralel (Varsayılan)
Tüm agentler eşzamanlı işler:Sıralı
Agentler sırayla işler (biri, öncekinin bitmesini bekler):Tam Örnek
Nasıl Çalışır
Mesaj Akışı
- Gelen mesaj bir WhatsApp grubuna ulaşır
- Yayın denetimi: Sistem, eş kimliğin
broadcastiçinde olup olmadığını kontrol eder - Yayın listesinde varsa:
- Listelenen tüm agentler mesajı işler
- Her agentin kendi oturum anahtarı ve yalıtılmış bağlamı vardır
- Agentler paralel (varsayılan) veya sıralı olarak işler
- Yayın listesinde değilse:
- Normal yönlendirme uygulanır (ilk eşleşen bağlama)
Oturum Yalıtımı
Bir yayın grubundaki her agent şu öğeleri tamamen ayrı tutar:- Oturum anahtarları (
agent:alfred:whatsapp:group:120363...veagent:baerbel:whatsapp:group:120363...) - Konuşma geçmişi (agent diğer agentlerin mesajlarını 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.mdvb.) - Grup bağlam arabelleği (bağlam için kullanılan son grup mesajları) eş başına paylaşılır; bu nedenle tüm yayın agentleri tetiklendiğinde aynı bağlamı görür
- Farklı kişilikler
- Farklı araç erişimi (ör. salt okunur ve okuma-yazma)
- Farklı modeller (ör. opus ve sonnet)
- Kurulu farklı Skills
Örnek: Yalıtılmış Oturumlar
120363403215116621@g.us grubunda ["alfred", "baerbel"] agentleriyle:
Alfred’in bağlamı:
En İyi Uygulamalar
1. Agentleri Odaklı Tutun
Her agenti tek ve net bir sorumlulukla tasarlayın:❌ Kötü: Tek bir genel “dev-helper” agenti
2. Açıklayıcı Adlar Kullanın
Her agentin ne yaptığını netleştirin:3. Farklı Araç Erişimi Yapılandırın
Agentlere yalnızca ihtiyaç duydukları araçları verin:4. Performansı İzleyin
Birçok agent ile şunları göz önünde bulundurun:- Hız için
"strategy": "parallel"(varsayılan) kullanın - Yayın gruplarını 5-10 agent ile sınırlayın
- Daha basit agentler için daha hızlı modeller kullanın
5. Hataları Zarifçe Ele Alın
Agentler bağımsız olarak başarısız olur. Bir agentin hatası diğerlerini engellemez: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:GROUP_A: Yalnızca alfred yanıt verir (normal yönlendirme)GROUP_B: agent1 VE agent2 yanıt verir (yayın)
broadcast, bindings üzerinde önceliğe sahiptir.
Sorun Giderme
Agentler Yanıt Vermiyor
Kontrol edin:- Agent kimlikleri
agents.listiçinde mevcut - Eş kimlik biçimi doğru (ör.
120363403215116621@g.us) - Agentler engelleme listelerinde değil
Yalnızca Bir Agent Yanıt Veriyor
Neden: Eş kimlikbindings içinde olabilir ancak broadcast içinde olmayabilir.
Düzeltme: Yayın yapılandırmasına ekleyin veya bindings içinden kaldırın.
Performans Sorunları
Birçok agent ile yavaşsa:- Grup başına agent sayısını azaltın
- Daha hafif modeller kullanın (
opusyerinesonnet) - Sandbox başlatma süresini kontrol edin
Örnekler
Örnek 1: Kod İnceleme Ekibi
Yanıtlar:
- code-formatter: “Girintiyi düzelttim ve tür ipuçları ekledim”
- security-scanner: “⚠️ 12. satırda SQL enjeksiyonu güvenlik açığı”
- test-coverage: “Kapsama %45, hata durumları için testler eksik”
- docs-checker: “
process_dataişlevi için docstring eksik”
Örnek 2: Çok Dilli Destek
API Referansı
Yapılandırma Şeması
Alanlar
strategy(isteğe bağlı): Agentlerin nasıl işleneceği"parallel"(varsayılan): Tüm agentler eşzamanlı işler"sequential": Agentler dizideki sıraya göre işler
[peerId]: WhatsApp grup JID’si, E.164 numarası veya başka bir eş kimlik- Değer: Mesajları işlemesi gereken agent kimliklerinin dizisi
Sınırlamalar
- Maksimum agent: Kesin bir sınır yoktur, ancak 10+ agent yavaş olabilir
- Paylaşılan bağlam: Agentler birbirlerinin yanıtlarını görmez (tasarım gereği)
- Mesaj sıralaması: Paralel yanıtlar herhangi bir sırada gelebilir
- Oran sınırları: Tüm agentler WhatsApp oran sınırlarına dahil edilir
Gelecekteki Geliştirmeler
Planlanan özellikler:- Paylaşılan bağlam modu (agentler birbirlerinin yanıtlarını görür)
- Agent koordinasyonu (agentler birbirlerine sinyal verebilir)
- Dinamik agent seçimi (mesaj içeriğine göre agent seçme)
- Agent öncelikleri (bazı agentler diğerlerinden önce yanıt verir)