स्थिति: प्रयोगात्मक। 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)
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, आदि)
उदाहरण: अलग-थलग सत्र
एजेंट["alfred", "baerbel"] वाले समूह 120363403215116621@g.us में:
- Alfred का संदर्भ
- Baerbel का संदर्भ
उपयोग के मामले
- विशिष्ट एजेंट टीमें: एक डेवलपमेंट समूह जहाँ
code-reviewer,security-auditor,test-generatorऔरdocs-checkerप्रत्येक समान संदेश का अपने दृष्टिकोण से उत्तर देते हैं। - बहुभाषी सहायता:
support-en,support-de,support-esवाली एक सहायता चैट, जिसमें वे अपनी भाषाओं में उत्तर देते हैं। - गुणवत्ता आश्वासन:
support-agentउत्तर देता है, जबकिqa-agentसमीक्षा करता है और केवल समस्याएँ मिलने पर उत्तर देता है। - कार्य स्वचालन:
task-tracker,time-loggerऔरreport-generatorसभी एक ही स्थिति अपडेट का उपयोग करते हैं।
सर्वोत्तम अभ्यास
1. एजेंटों को केंद्रित रखें
1. एजेंटों को केंद्रित रखें
एक सामान्य “dev-helper” एजेंट के बजाय प्रत्येक एजेंट को एक स्पष्ट जिम्मेदारी (
formatter, linter, tester) दें।2. वर्णनात्मक आईडी और नाम उपयोग करें
2. वर्णनात्मक आईडी और नाम उपयोग करें
3. अलग-अलग टूल एक्सेस कॉन्फ़िगर करें
3. अलग-अलग टूल एक्सेस कॉन्फ़िगर करें
reviewer केवल-पढ़ने योग्य है। fixer पढ़ और लिख सकता है।4. प्रदर्शन की निगरानी करें
4. प्रदर्शन की निगरानी करें
कई एजेंटों के साथ
"strategy": "parallel" (डिफ़ॉल्ट) को प्राथमिकता दें, ब्रॉडकास्ट समूहों में केवल कुछ एजेंट रखें और सरल एजेंटों के लिए तेज़ मॉडल उपयोग करें।5. विफलताएँ अलग रहती हैं
5. विफलताएँ अलग रहती हैं
एजेंट स्वतंत्र रूप से विफल होते हैं। एक एजेंट की त्रुटि लॉग की जाती है (
Broadcast agent <id> failed: ...) और अन्य एजेंटों को अवरुद्ध नहीं करती।संगतता
प्रदाता
ब्रॉडकास्ट समूह वर्तमान में केवल WhatsApp (वेब चैनल) के लिए कार्यान्वित हैं। अन्य चैनलbroadcast कॉन्फ़िगरेशन को अनदेखा करते हैं।
रूटिंग
ब्रॉडकास्ट समूह मौजूदा रूटिंग के साथ काम करते हैं:GROUP_A: केवल alfred उत्तर देता है (सामान्य रूटिंग)।GROUP_B: agent1 और agent2 उत्तर देते हैं (ब्रॉडकास्ट)।
प्राथमिकता:
broadcast को सामान्य रूट बाइंडिंग पर प्राथमिकता मिलती है। कॉन्फ़िगर की गई ACP बाइंडिंग (bindings[].type="acp") अनन्य होती हैं: जब कोई मेल खाती है, तो OpenClaw फ़ैन-आउट ब्रॉडकास्ट के बजाय कॉन्फ़िगर किए गए ACP सत्र पर भेजता है।समस्या निवारण
एजेंट उत्तर नहीं दे रहे
एजेंट उत्तर नहीं दे रहे
जाँचें:सफल फ़ैन-आउट
- एजेंट आईडी
agents.entriesमें मौजूद हैं (कॉन्फ़िगरेशन सत्यापन अज्ञात आईडी को अस्वीकार करता है)। - पीयर आईडी का प्रारूप सही है (समूह JID जैसे
120363403215116621@g.us, या DM के लिए E.164 जैसे+15551234567)। - संदेश सामान्य गेटिंग से गुज़रा है (उल्लेख/सक्रियण नियम अब भी लागू होते हैं)।
Broadcasting message to <n> agents (<strategy>) को लॉग करता है।केवल एक एजेंट उत्तर दे रहा है
केवल एक एजेंट उत्तर दे रहा है
कारण: पीयर आईडी सामान्य रूट बाइंडिंग में हो सकती है, लेकिन
broadcast में नहीं, या वह किसी अनन्य कॉन्फ़िगर की गई ACP बाइंडिंग से मेल खा सकती है।समाधान: सामान्य रूट से बँधे पीयर को ब्रॉडकास्ट कॉन्फ़िगरेशन में जोड़ें, या यदि फ़ैन-आउट ब्रॉडकास्ट वांछित है तो कॉन्फ़िगर की गई ACP बाइंडिंग हटाएँ/बदलें।प्रदर्शन संबंधी समस्याएँ
प्रदर्शन संबंधी समस्याएँ
यदि कई एजेंटों के साथ गति धीमी है: प्रत्येक समूह में एजेंटों की संख्या कम करें, हल्के मॉडल उपयोग करें और सैंडबॉक्स शुरू होने का समय जाँचें।
उदाहरण
उदाहरण 1: कोड समीक्षा टीम
उदाहरण 1: कोड समीक्षा टीम
उदाहरण 2: बहुभाषी पाइपलाइन
उदाहरण 2: बहुभाषी पाइपलाइन
API संदर्भ
कॉन्फ़िगरेशन स्कीमा
फ़ील्ड
"parallel" | "sequential"
डिफ़ॉल्ट:"\"parallel\""
एजेंटों को संसाधित करने का तरीका।
parallel सभी एजेंटों को एक साथ चलाता है; sequential उन्हें सरणी क्रम में चलाता है।string[]
WhatsApp समूह JID या E.164 फ़ोन नंबर। मान उन एजेंट आईडी की सरणी है जिन्हें उस पीयर के सभी संदेशों को संसाधित करना चाहिए।
सीमाएँ
- अधिकतम एजेंट: कोई निश्चित सीमा नहीं है, लेकिन बहुत-से एजेंट (10+) धीमे हो सकते हैं।
- साझा संदर्भ: एजेंट एक-दूसरे की प्रतिक्रियाएँ नहीं देखते हैं (यह अभिकल्पना के अनुसार है)।
- संदेश क्रम: समानांतर प्रतिक्रियाएँ किसी भी क्रम में आ सकती हैं।
- दर सीमाएँ: सभी उत्तर एक WhatsApp खाते से आते हैं, इसलिए प्रत्येक एजेंट का उत्तर उन्हीं WhatsApp दर सीमाओं में गिना जाता है।