मल्टी Agent सहयोग: एक Gateway पर कई विशेषज्ञ चलाना
OpenClaw मल्टी-agent आर्किटेक्चर एक Gateway प्रोसेस में कई आपस में अलग-अलग agent चला सकता है: हर agent का अपना वर्कस्पेस, स्टेट डायरेक्टरी (agentDir) और SQLite आधारित सेशन हिस्ट्री होती है, और यह एक साथ कई चैनल खाते भी जोड़ सकता है (जैसे दो WhatsApp नंबर)। इनबाउंड संदेश binding के ज़रिए सही agent तक रूट होते हैं।
लागू परिदृश्य
- आप एक «काम Claw» और एक «जीवन Claw» चाहते हैं, जिनके persona, मेमोरी और क्रेडेंशियल एक-दूसरे में हस्तक्षेप न करें।
- आपके पास एक जैसे कई चैनल खाते हैं — दो WhatsApp नंबर, दो Slack workspace — और आप हर एक से एक विशेषज्ञ जोड़ना चाहते हैं।
- टीम एक ही डिप्लॉयमेंट साझा करती है, और अलग-अलग सदस्यों या बिज़नेस लाइनों के लिए एक-एक समर्पित agent कॉन्फ़िगर किया जाता है।
पहले अवधारणाओं में अंतर समझें: इस पेज पर चैनल खाते के अनुसार रूटिंग वाले मल्टी agent की बात है। रिपॉज़िटरी में subagents और agent-send टूल के दस्तावेज़ भी हैं, जो agent के बीच सहयोग का दूसरा तरीका हैं।
तैयारी
- पढ़ लें व्यावहारिक परिदृश्य: अपना रास्ता चुनें, और पुष्टि करें कि मल्टी agent आपका चुना हुआ रास्ता है।
- एक चलता हुआ Gateway मौजूद है — मल्टी agent के लिए दूसरी प्रोसेस की ज़रूरत नहीं है।
- काम का बंटवारा सोच लें: कौन-सा चैनल खाता किस agent का है, और हर विशेषज्ञ के persona नियम उसके अपने
AGENTS.md/SOUL.mdमें लिखें।
मेरे साथ करें: 3 चरणों में कई विशेषज्ञ चलाएं
चरण 1: openclaw agents add से कई विशेषज्ञ agent बनाएं
हर विशेषज्ञ के लिए अलग agent क्यों बनाएं? क्योंकि एक agent एक पूर्ण persona स्कोप होता है, जिसमें तीन चीज़ें पहले से शामिल होती हैं:
- वर्कस्पेस: फ़ाइलें,
AGENTS.md/SOUL.md/USER.md, लोकल नोट्स, persona नियम। - स्टेट डायरेक्टरी
agentDir: auth profiles, मॉडल रजिस्ट्री, हर agent की कॉन्फ़िगरेशन — डिफ़ॉल्ट रूप से~/.openclaw/agents/<agentId>/agentमें। - सेशन डेटाबेस: चैट हिस्ट्री और रूटिंग स्थिति,
<agentDir>/openclaw-agent.sqliteमें संग्रहीत — डिफ़ॉल्ट लेआउट में यानी~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite।
हर विशेषज्ञ के लिए एक बार agents add चलाएं — उदाहरण «जीवन Claw» और «काम Claw» बनाता है:
openclaw agents add home
openclaw agents add workआम फ़्लैग: --role <role> (रोल टेम्पलेट लागू करें), --workspace <dir>, --model <id>, --agent-dir <dir>, --bind <channel[:accountId]> (दोहराया जा सकता है, बनाते समय binding भी बना देता है); --non-interactive को --workspace के साथ उपयोग करना होगा, जब तक --role निर्दिष्ट न हो।
आपको यह दिखना चाहिए: हर agent को अपना वर्कस्पेस मिलता है (SOUL.md, AGENTS.md और वैकल्पिक USER.md सहित), अलग agentDir और सेशन डेटाबेस, और agent फ़ाइलें डिफ़ॉल्ट रूप से ~/.openclaw/agents/<agentId> के नीचे रखी जाती हैं। निर्माण विज़ार्ड यह भी पूछेगा कि क्या अभी binding जोड़नी है — इसे छोड़ सकते हैं, अगले चरण में हाथ से लिखेंगे।
चरण 2: binding से चैनल खातों को संबंधित agent से जोड़ें
binding केवल तय करता है कि «यह संदेश किस agent का है» — यह न तो चैनल खाता बनाता है, न ही एक्सेस देता है, इसलिए पहले खाता कॉन्फ़िगर करें, फिर बाइंड करें। एक Gateway पर कई खाते जोड़े जा सकते हैं, जैसे दो WhatsApp नंबर दो विशेषज्ञों से अलग-अलग बाइंड करना।
पहले हर agent के लिए एक चैनल खाता तैयार करें:
openclaw channels login --channel whatsapp --account personal
openclaw channels login --channel whatsapp --account bizफिर ~/.openclaw/openclaw.json (JSON5) में agent और खाते जोड़ें: agents.entries agent की सूची देता है, bindings रूटिंग घोषित करता है।
{
agents: {
entries: {
home: {
workspace: "~/.openclaw/workspace-home",
agentDir: "~/.openclaw/agents/home/agent",
},
work: {
workspace: "~/.openclaw/workspace-work",
agentDir: "~/.openclaw/agents/work/agent",
},
},
},
// 固定路由顺序:先匹配的赢,窄规则写在宽规则前面。
bindings: [
{ agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
{ agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
],
}खाता-स्तरीय और सेशन-स्तरीय binding का अंतर — ज़रूरत के अनुसार चुनें:
- खाता-स्तरीय: केवल
channel+accountIdलिखें, पूरे खाते के संदेश इसी agent के होंगे।accountId: "*"चैनल-स्तरीय फ़ॉलबैक है;accountIdछोड़ने पर केवल उस चैनल का डिफ़ॉल्ट खाता मैच होता है। - सेशन-स्तरीय:
match.peerजोड़ें (kindमानdirect/group/channel, चैनल का स्थिर peer ID उपयोग करें, प्रदर्शित नाम नहीं), केवल एक खास बातचीत को विशेषज्ञ तक रूट करें। - प्राथमिकता: विशिष्ट सेशन और ग्रुप मैच, खाता-स्तरीय और चैनल फ़ॉलबैक पर भारी पड़ते हैं; एक ही स्तर के भीतर कॉन्फ़िगरेशन क्रम में पहले आने वाला मैच जीतता है।
आपको यह दिखना चाहिए: वैध binding बदलाव डिफ़ॉल्ट hybrid हॉट-रीलोड मोड में अपने आप लागू हो जाते हैं; यदि gateway.reload.mode का मान off है, तो लागू होने के लिए Gateway रीस्टार्ट करना होगा। ऐसे खाते की ओर इशारा करने वाली binding जिसे चैनल कभी स्वीकार नहीं करता, कोई काम नहीं करेगी।
चरण 3: संदेश भेजकर रूटिंग और आइसोलेशन सत्यापित करें
कॉन्फ़िगरेशन लिख देना इस बात की गारंटी नहीं कि रूटिंग सही है — पहले कमांड से रोस्टर और बाइंडिंग जांचें, फिर असली संदेशों से हर एक को अलग-अलग जांचें:
openclaw agents list --bindings
openclaw channels status --probeफिर हर बाइंड किए खाते से एक-एक संदेश भेजें और तीन बातें पुष्टि करें: संदेश सही agent में पहुंचा; हर एक की सेशन हिस्ट्री स्वतंत्र है; persona नियम हर एक पर अलग-अलग लागू होते हैं।
आपको यह दिखना चाहिए: agents list --bindings agent रोस्टर और «चैनल खाता → agent» बाइंडिंग संबंध दिखाता है, channels status --probe हर खाते की ऑनलाइन स्थिति दिखाता है। यदि कोई binding मैच नहीं होती और कोई उपयोगी डिफ़ॉल्ट असाइनमेंट नहीं है, तो रूटिंग AGENT_SELECTION_REQUIRED एरर देती है और आपको एक binding जोड़ने का संकेत देती है। तीनों बातें पास हो जाएं, तो आपके कई विशेषज्ञ एक ही Gateway में अपनी-अपनी जगह पर तैनात हैं।
चेकपॉइंट
- कभी दोबारा उपयोग न करें
agentDir। दो agent एक ही डायरेक्टरी की ओर इशारा करें, तो auth और session स्थिति में टकराव होगा। - OAuth में इनहेरिट व्यवहार है: जब सहायक agent का लोकल OAuth क्रेडेंशियल एक्सपायर हो या रिफ़्रेश फ़ेल हो, तो OpenClaw मुख्य agent से उसी profile का क्रेडेंशियल पढ़ता है, ज़्यादा नया token अपनाता है, और refresh token को सहायक agent के स्टोरेज में कॉपी नहीं करता। पूरी तरह स्वतंत्र OAuth खाते के लिए उस agent से खुद एक बार लॉगिन करें।
- हाथ से क्रेडेंशियल कॉपी करने पर केवल स्थिर आइटम कॉपी होते हैं:
api_key/tokenजैसे profile कॉपी किए जा सकते हैं; OAuth refresh सामग्री डिफ़ॉल्ट रूप से पोर्टेबल नहीं है, जब तकcopyToAgentsसे स्पष्ट रूप से शामिल न किया जाए। - Skills दो रास्तों से लोड होते हैं: हर agent अपने वर्कस्पेस से Skills लोड करता है, और साझा रूट (जैसे
~/.openclaw/skills) भी पढ़ता है।
सीमाएँ
- कई agent अभी भी उसी Gateway प्रोसेस में रहते हैं, ट्रस्ट बाउंड्री नहीं बदलती; मॉडल और agent harness दोनों बदले जा सकने वाले प्लगइन हैं।
- चैनल क्षमताएँ प्लगइन पर निर्भर करती हैं: WeChat प्लगइन केवल निजी चैट को समर्थन देता है, ग्रुप चैट को नहीं, इसलिए "WeChat ग्रुप से बाइंड करना" योजना में शामिल मत करें।
- सेशन हिस्ट्री सीमित क्रॉस-सेशन रिकॉल प्रदान करती है, असीमित मेमोरी नहीं।
अगला कदम
- अकाउंट और सेशन-स्तर के पूर्ण कॉन्फ़िगरेशन उदाहरणों के लिए आधिकारिक Agent bindings दस्तावेज़ देखें (
docs/concepts/agent-bindings.md)। - किसी एक विशेषज्ञ को क्षमता जोड़ने के लिए: Skills से शुरुआत: इंस्टॉल, उपयोग और कॉन्फ़िगरेशन।
- विशेषज्ञ को लंबे समय का संदर्भ याद रखने के लिए: मेमोरी सिस्टम: Claw को आपको याद रखने दें।
- अगर आप चाहते हैं कि यह मल्टी-agent विशेषज्ञ लाइनअप 7×24 हमेशा चालू रहे: अगला पेज सर्वर डिप्लॉय: Docker/VPS पर 7×24 चलाना।