Skip to main content
Durum: Deneysel. 2026.1.9 sürümünde eklendi. Yalnızca WhatsApp (web kanalı).

Genel bakış

Yayın grupları, aynı gelen mesaj üzerinde birden fazla agent çalıştırır. Her agent mesajı 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 DM’de 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 bir bahsetme olduğunda). Yalnızca hangi agent’ların çalışacağını değiştirirler; bir mesajın işlenmeye uygun olup olmadığını asla değiştirmezler. Canlı WhatsApp QA hattı, bahsetme içeren tek bir grup mesajının yapılandırılmış iki agent’tan farklı ve görünür yanıtlar üretebildiğini doğrulayan whatsapp-broadcast-group-fanout öğesini içerir.

Yapılandırma

Temel kurulum

Üst düzeye (bindings yanına) bir broadcast bölümü ekleyin. Anahtarlar WhatsApp eş kimlikleri, değerler ise agent kimliği dizileridir:
  • grup sohbetleri: grup JID’si (ör. 120363403215116621@g.us)
  • DM’ler: gönderenin E.164 telefon numarası (ör. +15551234567)
Sonuç: OpenClaw bu sohbette yanıt vereceği zaman üç agent’ın tümünü çalıştırır. Listelenen her agent kimliği agents.entries içinde bulunmalıdır: yapılandırma doğrulaması bilinmeyen kimlikleri bildirir ve çalışma zamanı bunları bir Broadcast agent <id> not found in agents.entries; skipping uyarısıyla atlar.

İşleme stratejisi

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

Tam örnek

Nasıl çalışır?

Mesaj akışı

1

Gelen mesaj ulaşır

Bir WhatsApp grup veya DM mesajı ulaşır.
2

Yönlendirme ve kabul

OpenClaw kanal izin listelerini, grup etkinleştirme kurallarını ve yapılandırılmış ACP bağlama sahipliğini uygular.
3

Yayın denetimi

Yapılandırılmış hiçbir ACP bağlaması yönlendirmenin sahibi değilse OpenClaw, eş kimliğinin broadcast içinde olup olmadığını denetler.
4

Yayın uygulanırsa

  • Listelenen tüm agent’lar mesajı işler.
  • Her agent’ın kendi oturum anahtarı ve yalıtılmış bağlamı vardır.
  • Agent’lar paralel (varsayılan) veya sıralı olarak işler.
  • Ses ekleri dağıtımdan önce bir kez yazıya dökülür; böylece agent’lar ayrı STT çağrıları yapmak yerine tek bir dökümü paylaşır.
5

Yayın uygulanmazsa

OpenClaw, sıradan yönlendirmeyi veya yönlendirme sırasında seçilen yapılandırılmış ACP oturum yönlendirmesini gönderir.
Yayın grupları, kanal izin listelerini veya grup etkinleştirme kurallarını (bahsetmeler/komutlar/vb.) atlamaz. Yalnızca bir mesaj işlenmeye uygun olduğunda hangi agent’ların çalışacağını değiştirirler.

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ıldıysa 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 mesajları) 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:

Kullanım alanları

  • Uzmanlaşmış agent ekipleri: code-reviewer, security-auditor, test-generator ve docs-checker öğelerinin aynı mesajı kendi bakış açılarından yanıtladığı bir geliştirme grubu.
  • Çok dilli destek: support-en, support-de ve support-es öğelerinin 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 öğelerinin tümü aynı durum güncellemesini işler.

En iyi uygulamalar

Her agent’a tek ve net bir sorumluluk (formatter, linter, tester) verin; tek bir genel “dev-helper” agent’ı kullanmayın.
reviewer salt okunurdur. fixer okuyabilir ve yazabilir.
Çok sayıda agent kullanırken "strategy": "parallel" seçeneğini (varsayılan) tercih edin, yayın gruplarını birkaç agent’la sınırlı tutun ve daha basit agent’lar için daha hızlı modeller kullanın.
Agent’lar birbirinden bağımsız olarak başarısız olur. Bir agent’ın hatası günlüğe kaydedilir (Broadcast agent <id> failed: ...) ve diğerlerini engellemez.

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:
  • GROUP_A: yalnızca alfred yanıt verir (normal yönlendirme).
  • GROUP_B: agent1 VE agent2 yanıt verir (yayın).
Öncelik: broadcast, sıradan yönlendirme bağlamalarından önceliklidir. Yapılandırılmış ACP bağlamaları (bindings[].type="acp") özeldir: biri eşleştiğinde OpenClaw, dağıtımlı yayın yerine yapılandırılmış ACP oturumuna gönderim yapar.

Sorun giderme

Şunları denetleyin:
  1. Agent kimlikleri agents.entries içinde bulunuyor (yapılandırma doğrulaması bilinmeyen kimlikleri reddeder).
  2. Eş kimliği biçimi doğru (gruplar için 120363403215116621@g.us gibi bir grup JID’si veya DM’ler için +15551234567 gibi bir E.164 numarası).
  3. Mesaj normal geçit denetiminden geçti (bahsetme/etkinleştirme kuralları uygulanmaya devam eder).
Hata ayıklama:
Başarılı bir dağıtım Broadcasting message to <n> agents (<strategy>) günlüğünü oluşturur.
Neden: eş kimliği sıradan yönlendirme bağlamalarında bulunuyor ancak broadcast içinde bulunmuyor olabilir ya da özel bir yapılandırılmış ACP bağlamasıyla eşleşebilir.Düzeltme: sıradan yönlendirmeye bağlı eşleri yayın yapılandırmasına ekleyin veya dağıtımlı yayın isteniyorsa yapılandırılmış ACP bağlamasını kaldırın/değiştirin.
Çok sayıda agent kullanıldığında yavaşsa: grup başına agent sayısını azaltın, daha hafif modeller kullanın ve korumalı alan başlatma süresini denetleyin.

Örnekler

Gruptaki tek bir kod parçacığı dört yanıt üretir: biçimlendirme düzeltmeleri, bir güvenlik bulgusu, bir kapsam eksikliği ve küçük bir dokümantasyon sorunu.

API başvurusu

Yapılandırma şeması

Alanlar

"parallel" | "sequential"
varsayılan:"\"parallel\""
Agent’ların nasıl işleneceği. parallel tüm agent’ları eşzamanlı çalıştırır; sequential ise bunları dizi sırasına göre çalıştırır.
string[]
WhatsApp grup JID’si veya E.164 telefon numarası. Değer, bu eşten gelen mesajların tümünü işlemesi gereken agent kimliklerinin dizisidir.

Sınırlamalar

  1. Maksimum ajan sayısı: kesin bir sınır yoktur, ancak çok sayıda ajan (10+) yavaş çalışabilir.
  2. Paylaşılan bağlam: ajanlar tasarım gereği birbirlerinin yanıtlarını görmez.
  3. Mesaj sıralaması: paralel yanıtlar herhangi bir sırayla ulaşabilir.
  4. Hız sınırları: tüm yanıtlar tek bir WhatsApp hesabından geldiği için her ajanın yanıtı aynı WhatsApp hız sınırlarına dâhil edilir.

İlgili