Yayın Grupları
Durum: DeneyselSürüm: 2026.1.9 sürümünde eklendi
Genel Bakış
Yayın Grupları, birden fazla ajanın 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ış ajan ekipleri oluşturmanıza olanak tanır — hepsi tek bir telefon numarası kullanarak. Mevcut 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 normalde ne zaman yanıt verecekse (örneğin: grup ayarlarınıza bağlı olarak bahsedildiğinde) yayınların da o zaman gerçekleştiği anlamına gelir.Kullanım Senaryoları
1. Uzmanlaşmış Ajan Ekipleri
Atomik ve odaklı sorumluluklara sahip birden fazla ajanı devreye alın:2. Çok Dilli Destek
3. Kalite Güvence İş Akışları
4. Görev Otomasyonu
Yapılandırma
Temel Kurulum
Üst düzeyde birbroadcast bölümü ekleyin (bindings’nin yanına). Anahtarlar WhatsApp eş kimlikleridir:
- grup sohbetleri: grup JID’si (örn.
[email protected]) - DM’ler: E.164 telefon numarası (örn.
+15551234567)
İşleme Stratejisi
Ajanların mesajları nasıl işleyeceğini kontrol edin:Paralel (Varsayılan)
Tüm ajanlar eşzamanlı olarak işler:Ardışık
Ajanlar sırayla işlem yapar (öncekinin bitmesini bekler):Eksiksiz Örnek
Nasıl Çalışır
Mesaj Akışı
- Gelen mesaj bir WhatsApp grubuna ulaşır
- Yayın kontrolü: Sistem, eş kimliğin
broadcastiçinde olup olmadığını kontrol eder - Yayın listesinde ise:
- Listelenen tüm ajanlar mesajı işler
- Her ajanın kendi oturum anahtarı ve yalıtılmış bağlamı vardır
- Ajanlar 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 ajan tamamen ayrı olan şunları korur:- Oturum anahtarları (
agent:alfred:whatsapp:group:120363...ileagent:baerbel:whatsapp:group:120363...) - Konuşma geçmişi (ajan diğer ajanların 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.md vb.)
- Grup bağlam arabelleği (bağlam için kullanılan son grup mesajları) eş başına paylaşılır; bu nedenle tetiklendiğinde tüm yayın ajanları aynı bağlamı görür
- Farklı kişilikler
- Farklı araç erişimleri (örn. salt okunur vs. okuma-yazma)
- Farklı modeller (örn. opus vs. sonnet)
- Farklı Skills kurulumları
Örnek: Yalıtılmış Oturumlar
[email protected] grubunda, ["alfred", "baerbel"] ajanları ile:
Alfred’in bağlamı:
En İyi Uygulamalar
1. Ajanları Odaklı Tutun
Her ajanı tek ve net bir sorumlulukla tasarlayın:❌ Kötü: Tek bir genel “dev-helper” ajan
2. Açıklayıcı İsimler Kullanın
Her ajanın ne yaptığını netleştirin:3. Farklı Araç Erişimleri Yapılandırın
Ajanlara yalnızca ihtiyaç duydukları araçları verin:4. Performansı İzleyin
Çok sayıda ajanla şunları göz önünde bulundurun:- Hız için
"strategy": "parallel"(varsayılan) kullanımı - Yayın gruplarını 5–10 ajanla sınırlama
- Daha basit ajanlar için daha hızlı modeller kullanma
5. Hataları Zarif Şekilde Yönetin
Ajanlar bağımsız olarak hata verir. Bir ajanın hatası diğerlerini engellemez:Uyumluluk
Sağlayıcılar
Yayın grupları şu anda şunlarla çalışır:- ✅ WhatsApp (uygulandı)
- 🚧 Telegram (planlanıyor)
- 🚧 Discord (planlanıyor)
- 🚧 Slack (planlanıyor)
Yönlendirme
Yayın grupları mevcut yönlendirme ile birlikte çalışır:GROUP_A: Yalnızca alfred yanıtlar (normal yönlendirme)GROUP_B: agent1 VE agent2 yanıtlar (yayın)
broadcast, bindings’ye göre önceliklidir.
Sorun Giderme
Ajanlar Yanıt Vermiyor
Kontrol edin:- Ajan kimliklerinin
agents.listiçinde mevcut olması - Eş kimliği biçiminin doğru olması (örn.
[email protected]) - Ajanlar engelleme listelerinde değil
Yalnızca Bir Ajan Yanıt Veriyor
Neden: Eş kimliğibindings içinde olabilir ancak broadcast içinde olmayabilir.
Çözüm: Yayın yapılandırmasına ekleyin veya bağlamalardan kaldırın.
Performans Sorunları
Çok sayıda ajanla yavaşsa:- Grup başına ajan sayısını azaltın
- Daha hafif modeller kullanın (opus yerine sonnet)
- 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 zafiyeti”
- test-coverage: “Kapsama %45, hata durumları için testler eksik”
- docs-checker: “
process_datafonksiyonu için docstring eksik”
Örnek 2: Çok Dilli Destek
API Referansı
Yapılandırma Şeması
Alanlar
strategy(isteğe bağlı): Ajanların nasıl işleneceği"parallel"(varsayılan): Tüm ajanlar eşzamanlı işlem yapar"sequential": Ajanlar dizi sırasına göre işlem yapar
[peerId]: WhatsApp grup JID’si, E.164 numarası veya diğer eş kimliği- Değer: Mesajları işlemesi gereken ajan kimliklerinin dizisi
Sınırlamalar
- Maks. ajanlar: Kesin bir sınır yok, ancak 10+ ajan yavaş olabilir
- Paylaşılan bağlam: Ajanlar birbirlerinin yanıtlarını görmez (tasarım gereği)
- Mesaj sıralaması: Paralel yanıtlar herhangi bir sırayla gelebilir
- Hız sınırları: Tüm ajanlar WhatsApp hız sınırlarına dahil edilir
Gelecek Geliştirmeler
Planlanan özellikler:- Paylaşılan bağlam modu (ajanlar birbirlerinin yanıtlarını görür)
- Ajan koordinasyonu (ajanlar birbirlerine sinyal gönderebilir)
- Dinamik ajan seçimi (mesaj içeriğine göre ajan seçme)
- Ajan öncelikleri (bazı ajanlar diğerlerinden önce yanıtlar)