ClawRouter

ClawRouter, OpenClaw को कई अपस्ट्रीम मॉडल प्रदाताओं के लिए एक नीति-सीमित कुंजी देता है। बंडल किया गया clawrouter Plugin केवल उस कुंजी के लिए अनुमत मॉडलों को खोजता है, प्रत्येक मॉडल को उसके घोषित प्रोटोकॉल के माध्यम से रूट करता है, और OpenClaw के उपयोग इंटरफ़ेस पर कुंजी के बजट तथा समेकित उपयोग की रिपोर्ट देता है।

अपस्ट्रीम क्रेडेंशियल और प्रदाता-विशिष्ट फ़ॉरवर्डिंग ClawRouter में ही रहते हैं, इसलिए OpenClaw होस्ट पर प्रत्येक अपस्ट्रीम प्रदाता Plugin को कभी भी इंस्टॉल या प्रमाणित करने की आवश्यकता नहीं होती। यह Plugin OpenClaw (enabledByDefault: true) के साथ बंडल किया हुआ आता है; आपको केवल जारी किया गया ClawRouter क्रेडेंशियल चाहिए।

आरंभ करना

export CLAWROUTER_API_KEY="..."openclaw onboard --auth-choice clawrouter-api-keyopenclaw plugins enable clawrouter

openclaw models list --all --provider clawrouter

openclaw models set clawrouter/<provider>/<model>

प्रबंधित गैर-संवादात्मक परिनियोजन

प्रॉक्सी कुंजी को वर्कलोड के सीक्रेट इंजेक्शन में रखें और openclaw.json में केवल SecretRef संग्रहित करें। मानक प्रबंधित फ़ील्ड ये हैं:

उदाहरण के लिए, कोई परिनियोजन नियंत्रक इस JSON5 पैच का स्वामी हो सकता है:

{  plugins: {    entries: { clawrouter: { enabled: true } },  },  models: {    providers: {      clawrouter: {        baseUrl: "https://clawrouter.internal.example",        apiKey: {          source: "env",          provider: "default",          id: "CLAWROUTER_API_KEY",        },        headers: {          "X-ClawRouter-Project-Id": "fakeco",        },      },    },  },  agents: {    defaults: {      model: { primary: "clawrouter/openai/gpt-5.5" },    },  },}

यदि परिनियोजन plugins.allow सेट करता है, तो उसकी मौजूदा प्रविष्टियाँ बनाए रखें और clawrouter जोड़ें। संवादात्मक विज़ार्ड के बिना सत्यापित करके लागू करें:

openclaw config patch --file ./clawrouter.patch.json5 --dry-run --jsonopenclaw config patch --file ./clawrouter.patch.json5

ड्राई रन SecretRef को रिज़ॉल्व करता है, लेकिन उसका मान कभी प्रिंट नहीं करता। क्रेडेंशियल रोटेट करने के लिए, CLAWROUTER_API_KEY प्रदान करने वाले बाहरी Secret को अपडेट करें और Gateway वर्कलोड पुनः आरंभ करें, ताकि नया प्रक्रिया परिवेश लोड हो जाए। कॉन्फ़िगरेशन फ़ाइल और मॉडल संदर्भ नहीं बदलते।

स्रोत से बनाए गए स्टैंडअलोन Docker Gateway के लिए, ClawRouter पहले से ही रूट रनटाइम में शामिल है। केवल वह चैनल Plugin चुनें जिसे अलग पैकेजिंग चाहिए, जैसे OPENCLAW_EXTENSIONS=clickclack, slack, या msteams; देखें चयनित Plugins के साथ स्रोत से बनी इमेज। आर्काइव/एप्लायंस परिनियोजनों को OCI इमेज का उपयोग करने के बजाय उसी लैंड किए गए स्रोत को अपनी आर्टिफ़ैक्ट पाइपलाइन के माध्यम से पैकेज करना होगा।

तत्परता और लाइव प्रमाण

ये जाँचें अलग-अलग सीमाओं को प्रमाणित करती हैं; किसी एक के स्थान पर दूसरी का उपयोग न करें:

# केवल ClawRouter प्रक्रिया का स्वास्थ्य; किसी क्रेडेंशियल या अपस्ट्रीम मॉडल का प्रयोग नहीं किया जाता।curl -fsS https://clawrouter.internal.example/v1/health # केवल OpenClaw Gateway स्टार्टअप की तत्परता; कोई मॉडल कॉल नहीं की जाती।curl -fsS http://127.0.0.1:18789/readyz # क्रेडेंशियल-सीमित कैटलॉग खोज।openclaw models list --all --provider clawrouter --json # कॉन्फ़िगर किए गए ClawRouter प्रदाता के माध्यम से न्यूनतम वास्तविक इन्फ़रेंस जाँच।openclaw models status --probe --probe-provider clawrouter --probe-max-tokens 8 --json # सटीक प्रदत्त मॉडल संदर्भ का उपयोग करने वाला वर्कलोड कैनरी।openclaw agent --agent main \  --model clawrouter/openai/gpt-5.5 \  --message "ठीक यही उत्तर दें: CLAWROUTER_CANARY_OK" \  --json

उदाहरण मॉडल को आँख मूँदकर कॉपी करने के बजाय सीमित कैटलॉग द्वारा लौटाए गए मॉडल का उपयोग करें। सफल /readyz प्रतिक्रिया का अर्थ है कि Gateway अनुरोधों को सेवा दे सकता है; इसका यह दावा नहीं है कि ClawRouter, उसका क्रेडेंशियल या कोई अपस्ट्रीम प्रदाता तैयार है। मॉडल जाँच और एजेंट कैनरी इन्फ़रेंस के प्रमाण हैं।

लाइव निदान के लिए, कैनरी जारी करें और Gateway के मानक लॉग देखें। मौजूदा केवल-मेटाडेटा मॉडल ट्रांसपोर्ट डायग्नोस्टिक्स इस प्रकार की पंक्तियाँ उत्सर्जित करते हैं:

[model-fetch] प्रारंभ provider=clawrouter api=openai-responses model=openai/gpt-5.5 method=POST url=https://clawrouter.internal.example/v1/responses[model-fetch] प्रतिक्रिया provider=clawrouter api=openai-responses model=openai/gpt-5.5 status=200

जब वे पहचानकर्ता उपलब्ध होते हैं, तो Plugin सीमित X-ClawRouter-Client, X-ClawRouter-Agent-Id, और X-ClawRouter-Session-Id हेडर भेजता है। यह मॉडल कॉल के डायग्नोस्टिक callId (<run-id>:model:<n>) को X-Request-ID में मैप भी करता है, ताकि OpenClaw मॉडल-कॉल ईवेंट को ClawRouter के केवल-मेटाडेटा ऑडिट ट्रेल से जोड़ा जा सके। 128-वर्ण अनुरोध-id बजट के भीतर के मान समान रहते हैं। लंबे मान :model:<n> प्रत्यय और एक नियतात्मक हैश बनाए रखते हैं, ताकि अलग-अलग कॉल सीमित और जोड़ने योग्य रहें। स्थिर परिनियोजन मेटाडेटा, जैसे X-ClawRouter-Project-Id, प्रदाता के headers मैप में सेट किया जा सकता है। एजेंट और सत्र एट्रिब्यूशन हेडर अपनी अलग 256-वर्ण सीमा बनाए रखते हैं। ClawRouter के ASCII पहचानकर्ता सेट से बाहर के वर्णों वाले स्वचालित अनुरोध id भी उसी नियतात्मक सीमित रूप का उपयोग करते हैं। स्पष्ट रूप से कॉन्फ़िगर किए गए हेडर, जिनमें X-Request-ID का कोई भी केस वेरिएंट शामिल है, स्वचालित मानों पर प्राथमिकता पाते हैं। ट्रांसपोर्ट डायग्नोस्टिक रूटिंग और प्रतिक्रिया मेटाडेटा दर्ज करता है; यह क्रेडेंशियल, अनुरोध id, प्रॉम्प्ट या पूर्णताएँ लॉग नहीं करता। ClawRouter का अपना ऑडिट ईवेंट चयनित अपस्ट्रीम प्रदाता और सामग्री-प्रतिधारण स्थिति प्रदान करता है।

मॉडल खोज

GET /v1/catalog, { providers: [...] } लौटाता है, जहाँ प्रत्येक प्रदाता प्रविष्टि अपना models[] (अपस्ट्रीम id, क्षमताओं और मूल्य निर्धारण सहित) और अपने समर्थित अनुरोध रूट सूचीबद्ध करती है। OpenClaw, ClawRouter मॉडलों की दूसरी स्थिर सूची प्रदान नहीं करता। कोई कैटलॉग मॉडल OpenClaw मॉडल के रूप में तब प्रदर्शित होता है जब:

• क्रेडेंशियल की नीति उसके प्रदाता को अनुमति देती है;
• कैटलॉग मॉडल समर्थित LLM क्षमता (llm.responses, llm.chat, llm.messages, या मेल खाने वाले स्ट्रीमिंग रूट के साथ llm.stream) प्रदर्शित करता है; और
• प्रदाता नीचे दिए गए ट्रांसपोर्ट में से किसी एक के लिए मेल खाने वाला रूट उजागर करता है।

किसी समर्थित ClawRouter प्रदाता में मॉडल जोड़ने के लिए OpenClaw रिलीज़ की आवश्यकता नहीं होती: अगला कैटलॉग रीफ़्रेश (प्रति क्रेडेंशियल सीमा 60 सेकंड तक कैश किया गया) उसे खोज लेता है। जिस मॉडल को नया वायर प्रोटोकॉल चाहिए, उसके लिए पहले Plugin समर्थन आवश्यक है।

प्रोटोकॉल और प्रदाता Plugins

ClawRouter अपस्ट्रीम क्रेडेंशियल का स्वामी है; उसका कैटलॉग OpenClaw को बताता है कि कौन-सा ट्रांसपोर्ट उपयोग करना है, इसलिए आपको प्रत्येक अपस्ट्रीम कंपनी का प्रमाणीकरण Plugin कभी इंस्टॉल नहीं करना पड़ता।

Plugin उन परिवारों के लिए मेल खाने वाली रीप्ले और टूल-स्कीमा नीतियाँ भी लागू करता है (OpenAI/DeepSeek/Gemini/Perplexity टूल-स्कीमा संगतता; नेटिव Anthropic और Google Gemini रीप्ले नीतियाँ)। Perplexity मॉडलों को कठोर स्कीमा पुनर्लेखन मिलता है: patternProperties और additionalProperties हटाए जाते हैं तथा प्रत्येक ऑब्जेक्ट स्कीमा properties घोषित करता है, क्योंकि Perplexity इनके बिना टूल स्कीमा अस्वीकार करता है। केवल असमर्थित अनुरोध प्रारूप उजागर करने वाले कैटलॉग प्रदाता को जानबूझकर OpenClaw टेक्स्ट मॉडल के रूप में प्रदर्शित नहीं किया जाता। असंगत पेलोड भेजने के बजाय उन प्रदाताओं को ClawRouter में समर्थित अनुबंधों में से किसी एक के अनुरूप सामान्यीकृत करें।

कोटा और उपयोग

ClawRouter की /v1/usage प्रतिक्रिया सामान्य OpenClaw प्रदाता-उपयोग इंटरफ़ेस को डेटा देती है: अनुरोध, टोकन और व्यय के कुल योग, साथ ही कुंजी की सीमा होने पर मासिक बजट विंडो। मीटर-रहित कुंजियाँ प्रतिशत विंडो के बिना भी समेकित उपयोग दिखाती हैं।

कोटा लुकअप मॉडल खोज वाली उसी सीमित कुंजी का उपयोग करता है। विफल कोटा लुकअप मॉडल निष्पादन को अवरुद्ध नहीं करता।

लाइव स्नैपशॉट इससे जाँचें:

openclaw status --usageopenclaw models status

यही प्रदाता स्नैपशॉट चैट में /status और OpenClaw के उपयोग UI में उपलब्ध है। बजट पूरी नीति पर लागू होता है, इसलिए समान ClawRouter नीति का उपयोग करने वाले किसी अन्य क्लाइंट के अनुरोध शेष प्रतिशत बदल सकते हैं।

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

सुरक्षा व्यवहार

• कैटलॉग खोज कॉन्फ़िगर की गई प्रॉक्सी कुंजी तक सीमित होती है और प्रत्येक क्रेडेंशियल दायरे (एजेंट डायरेक्टरी, वर्कस्पेस डायरेक्टरी, प्रमाणीकरण प्रोफ़ाइल आईडी और आधार URL) के लिए कैश की जाती है।
• प्रॉक्सी कुंजी केवल अनुरोध भेजते समय संलग्न की जाती है; इसे मॉडल मेटाडेटा में संग्रहीत नहीं किया जाता।
• स्वचालित श्रेय और अनुरोध-सहसंबंध मानों से अतिरिक्त रिक्त स्थान हटाए जाते हैं और भेजने से पहले नियंत्रण वर्ण अस्वीकार कर दिए जाते हैं। श्रेय मान अधिकतम 256 वर्णों तक सीमित होते हैं; अनुरोध आईडी अधिकतम 128 वर्णों तक सीमित होती हैं।
• मॉडल ट्रांसपोर्ट निदान में केवल मेटाडेटा होता है और उसमें कभी भी प्रॉक्सी कुंजी या मॉडल सामग्री शामिल नहीं होती।
• मूल Anthropic और Gemini मॉडल आईडी को केवल अनुरोध भेजते समय उनकी अपस्ट्रीम आईडी में पुनर्लिखित किया जाता है।
• असमर्थित या अनुमति-रहित कैटलॉग पंक्तियाँ सुरक्षित रूप से विफल होती हैं और चयन योग्य नहीं होतीं।

संबंधित