Skip to main content
स्थिति: प्रयोगात्मक। 2026.1.9 में जोड़ा गया। केवल WhatsApp (वेब चैनल)।

अवलोकन

ब्रॉडकास्ट समूह एक ही इनबाउंड संदेश पर कई एजेंट चलाते हैं। प्रत्येक एजेंट संदेश को अपने अलग-थलग सत्र में संसाधित करता है और अपना उत्तर पोस्ट करता है, इसलिए एक WhatsApp नंबर किसी एक समूह चैट या DM में विशिष्ट एजेंटों की टीम को होस्ट कर सकता है। ब्रॉडकास्ट समूहों का मूल्यांकन चैनल अनुमति-सूचियों और समूह सक्रियण नियमों के बाद किया जाता है। WhatsApp समूहों में ब्रॉडकास्ट तब होते हैं जब OpenClaw सामान्यतः उत्तर देता (उदाहरण के लिए: उल्लेख किए जाने पर, आपकी समूह सेटिंग के आधार पर)। वे केवल यह बदलते हैं कि कौन-से एजेंट चलते हैं, यह कभी नहीं कि कोई संदेश संसाधन के लिए पात्र है या नहीं। लाइव WhatsApp QA लेन में whatsapp-broadcast-group-fanout शामिल है, जो सत्यापित करता है कि उल्लेख वाला एक समूह संदेश दो कॉन्फ़िगर किए गए एजेंटों से अलग-अलग दृश्यमान उत्तर उत्पन्न कर सकता है।

कॉन्फ़िगरेशन

बुनियादी सेटअप

एक शीर्ष-स्तरीय broadcast अनुभाग (bindings के पास) जोड़ें। कुंजियाँ WhatsApp पीयर आईडी हैं और मान एजेंट आईडी की सरणियाँ हैं:
  • समूह चैट: समूह JID (उदा. 120363403215116621@g.us)
  • DM: प्रेषक का E.164 फ़ोन नंबर (उदा. +15551234567)
परिणाम: जब OpenClaw इस चैट में उत्तर देता, तो यह तीनों एजेंट चलाता है। सूचीबद्ध प्रत्येक एजेंट आईडी का agents.entries में मौजूद होना आवश्यक है: कॉन्फ़िगरेशन सत्यापन अज्ञात आईडी की सूचना देता है और रनटाइम उन्हें Broadcast agent <id> not found in agents.entries; skipping चेतावनी के साथ छोड़ देता है।

संसाधन रणनीति

broadcast.strategy निर्धारित करता है कि एजेंट संदेश को कैसे संसाधित करते हैं:

पूरा उदाहरण

यह कैसे काम करता है

संदेश प्रवाह

1

इनकमिंग संदेश आता है

एक WhatsApp समूह या DM संदेश आता है।
2

रूटिंग और प्रवेश

OpenClaw चैनल अनुमति-सूचियाँ, समूह सक्रियण नियम और कॉन्फ़िगर किए गए ACP बाइंडिंग स्वामित्व को लागू करता है।
3

ब्रॉडकास्ट जाँच

यदि कोई कॉन्फ़िगर की गई ACP बाइंडिंग रूट की स्वामी नहीं है, तो OpenClaw जाँचता है कि पीयर आईडी broadcast में है या नहीं।
4

यदि ब्रॉडकास्ट लागू होता है

  • सभी सूचीबद्ध एजेंट संदेश को संसाधित करते हैं।
  • प्रत्येक एजेंट की अपनी सत्र कुंजी और अलग-थलग संदर्भ होता है।
  • एजेंट समानांतर (डिफ़ॉल्ट) या क्रमिक रूप से संसाधित करते हैं।
  • फ़ैन-आउट से पहले ऑडियो अटैचमेंट का एक बार प्रतिलेखन किया जाता है, इसलिए एजेंट अलग-अलग STT कॉल करने के बजाय एक प्रतिलेख साझा करते हैं।
5

यदि ब्रॉडकास्ट लागू नहीं होता है

OpenClaw सामान्य रूट या रूटिंग के दौरान चुने गए कॉन्फ़िगर किए गए ACP सत्र रूट पर भेजता है।
ब्रॉडकास्ट समूह चैनल अनुमति-सूचियों या समूह सक्रियण नियमों (उल्लेख/कमांड/आदि) को बायपास नहीं करते। जब कोई संदेश संसाधन के लिए पात्र होता है, तब वे केवल यह बदलते हैं कि कौन-से एजेंट चलते हैं

सत्र पृथक्करण

ब्रॉडकास्ट समूह का प्रत्येक एजेंट निम्न को पूरी तरह अलग रखता है:
  • सत्र कुंजियाँ (agent:alfred:whatsapp:group:120363... बनाम agent:baerbel:whatsapp:group:120363...)
  • वार्तालाप इतिहास (एक एजेंट अन्य एजेंटों के उत्तर नहीं देखता)
  • वर्कस्पेस (कॉन्फ़िगर होने पर अलग सैंडबॉक्स)
  • टूल एक्सेस (अलग अनुमति/अस्वीकृति सूचियाँ)
  • मेमोरी/संदर्भ (अलग IDENTITY.md, SOUL.md, आदि)
एक अपवाद को जानबूझकर साझा किया जाता है: समूह संदर्भ बफ़र (संदर्भ के लिए उपयोग किए जाने वाले हाल के समूह संदेश) प्रत्येक पीयर के लिए साझा होता है, इसलिए ट्रिगर होने पर सभी ब्रॉडकास्ट एजेंट समान संदर्भ देखते हैं। फ़ैन-आउट पूरा होने के बाद इसे एक बार साफ़ किया जाता है। इससे प्रत्येक एजेंट के अलग व्यक्तित्व, मॉडल, Skills और टूल एक्सेस (उदाहरण के लिए केवल-पढ़ने योग्य बनाम पढ़ने-लिखने योग्य) हो सकते हैं।

उदाहरण: अलग-थलग सत्र

एजेंट ["alfred", "baerbel"] वाले समूह 120363403215116621@g.us में:

उपयोग के मामले

  • विशिष्ट एजेंट टीमें: एक डेवलपमेंट समूह जहाँ code-reviewer, security-auditor, test-generator और docs-checker प्रत्येक समान संदेश का अपने दृष्टिकोण से उत्तर देते हैं।
  • बहुभाषी सहायता: support-en, support-de, support-es वाली एक सहायता चैट, जिसमें वे अपनी भाषाओं में उत्तर देते हैं।
  • गुणवत्ता आश्वासन: support-agent उत्तर देता है, जबकि qa-agent समीक्षा करता है और केवल समस्याएँ मिलने पर उत्तर देता है।
  • कार्य स्वचालन: task-tracker, time-logger और report-generator सभी एक ही स्थिति अपडेट का उपयोग करते हैं।

सर्वोत्तम अभ्यास

एक सामान्य “dev-helper” एजेंट के बजाय प्रत्येक एजेंट को एक स्पष्ट जिम्मेदारी (formatter, linter, tester) दें।
reviewer केवल-पढ़ने योग्य है। fixer पढ़ और लिख सकता है।
कई एजेंटों के साथ "strategy": "parallel" (डिफ़ॉल्ट) को प्राथमिकता दें, ब्रॉडकास्ट समूहों में केवल कुछ एजेंट रखें और सरल एजेंटों के लिए तेज़ मॉडल उपयोग करें।
एजेंट स्वतंत्र रूप से विफल होते हैं। एक एजेंट की त्रुटि लॉग की जाती है (Broadcast agent <id> failed: ...) और अन्य एजेंटों को अवरुद्ध नहीं करती।

संगतता

प्रदाता

ब्रॉडकास्ट समूह वर्तमान में केवल WhatsApp (वेब चैनल) के लिए कार्यान्वित हैं। अन्य चैनल broadcast कॉन्फ़िगरेशन को अनदेखा करते हैं।

रूटिंग

ब्रॉडकास्ट समूह मौजूदा रूटिंग के साथ काम करते हैं:
  • GROUP_A: केवल alfred उत्तर देता है (सामान्य रूटिंग)।
  • GROUP_B: agent1 और agent2 उत्तर देते हैं (ब्रॉडकास्ट)।
प्राथमिकता: broadcast को सामान्य रूट बाइंडिंग पर प्राथमिकता मिलती है। कॉन्फ़िगर की गई ACP बाइंडिंग (bindings[].type="acp") अनन्य होती हैं: जब कोई मेल खाती है, तो OpenClaw फ़ैन-आउट ब्रॉडकास्ट के बजाय कॉन्फ़िगर किए गए ACP सत्र पर भेजता है।

समस्या निवारण

जाँचें:
  1. एजेंट आईडी agents.entries में मौजूद हैं (कॉन्फ़िगरेशन सत्यापन अज्ञात आईडी को अस्वीकार करता है)।
  2. पीयर आईडी का प्रारूप सही है (समूह JID जैसे 120363403215116621@g.us, या DM के लिए E.164 जैसे +15551234567)।
  3. संदेश सामान्य गेटिंग से गुज़रा है (उल्लेख/सक्रियण नियम अब भी लागू होते हैं)।
डीबग:
सफल फ़ैन-आउट Broadcasting message to <n> agents (<strategy>) को लॉग करता है।
कारण: पीयर आईडी सामान्य रूट बाइंडिंग में हो सकती है, लेकिन broadcast में नहीं, या वह किसी अनन्य कॉन्फ़िगर की गई ACP बाइंडिंग से मेल खा सकती है।समाधान: सामान्य रूट से बँधे पीयर को ब्रॉडकास्ट कॉन्फ़िगरेशन में जोड़ें, या यदि फ़ैन-आउट ब्रॉडकास्ट वांछित है तो कॉन्फ़िगर की गई ACP बाइंडिंग हटाएँ/बदलें।
यदि कई एजेंटों के साथ गति धीमी है: प्रत्येक समूह में एजेंटों की संख्या कम करें, हल्के मॉडल उपयोग करें और सैंडबॉक्स शुरू होने का समय जाँचें।

उदाहरण

समूह में एक कोड स्निपेट चार उत्तर उत्पन्न करता है: फ़ॉर्मेटिंग सुधार, एक सुरक्षा निष्कर्ष, एक कवरेज अंतराल और दस्तावेज़ीकरण की एक छोटी समस्या।

API संदर्भ

कॉन्फ़िगरेशन स्कीमा

फ़ील्ड

"parallel" | "sequential"
डिफ़ॉल्ट:"\"parallel\""
एजेंटों को संसाधित करने का तरीका। parallel सभी एजेंटों को एक साथ चलाता है; sequential उन्हें सरणी क्रम में चलाता है।
string[]
WhatsApp समूह JID या E.164 फ़ोन नंबर। मान उन एजेंट आईडी की सरणी है जिन्हें उस पीयर के सभी संदेशों को संसाधित करना चाहिए।

सीमाएँ

  1. अधिकतम एजेंट: कोई निश्चित सीमा नहीं है, लेकिन बहुत-से एजेंट (10+) धीमे हो सकते हैं।
  2. साझा संदर्भ: एजेंट एक-दूसरे की प्रतिक्रियाएँ नहीं देखते हैं (यह अभिकल्पना के अनुसार है)।
  3. संदेश क्रम: समानांतर प्रतिक्रियाएँ किसी भी क्रम में आ सकती हैं।
  4. दर सीमाएँ: सभी उत्तर एक WhatsApp खाते से आते हैं, इसलिए प्रत्येक एजेंट का उत्तर उन्हीं WhatsApp दर सीमाओं में गिना जाता है।

संबंधित