Providers
ClawRouter
ClawRouter, OpenClaw को कई अपस्ट्रीम मॉडल प्रदाताओं के लिए एक नीति-स्कोप्ड कुंजी देता है। बंडल किया गया Plugin केवल उस कुंजी के लिए अनुमत मॉडलों को खोजता है, हर मॉडल को उसके घोषित प्रोटोकॉल के ज़रिए रूट करता है, और OpenClaw उपयोग सतहों पर कुंजी का बजट और कुल उपयोग रिपोर्ट करता है।
आप OpenClaw होस्ट पर हर अपस्ट्रीम प्रदाता Plugin को इंस्टॉल या प्रमाणित नहीं करते। अपस्ट्रीम क्रेडेंशियल और प्रदाता-विशिष्ट फ़ॉरवर्डिंग
ClawRouter में रहते हैं। OpenClaw को केवल बंडल किए गए @openclaw/clawrouter Plugin और जारी किए गए
ClawRouter क्रेडेंशियल की ज़रूरत होती है।
| गुण | मान |
|---|---|
| प्रदाता | clawrouter |
| पैकेज | @openclaw/clawrouter |
| प्रमाणीकरण | CLAWROUTER_API_KEY |
| डिफ़ॉल्ट URL | https://clawrouter.openclaw.ai |
| मॉडल कैटलॉग | /v1/catalog के ज़रिए क्रेडेंशियल-स्कोप्ड |
| कोटा | /v1/usage के ज़रिए मासिक बजट और उपयोग |
शुरू करना
Get a scoped credential
अपने ClawRouter व्यवस्थापक से ऐसा क्रेडेंशियल मांगें जिसकी नीति में वे प्रदाता, मॉडल और मासिक बजट शामिल हों जिनका आपको उपयोग करना चाहिए। क्रेडेंशियल जारी किए जाने पर एक बार दिखाए जाते हैं।
Configure OpenClaw
export CLAWROUTER_API_KEY="..."openclaw onboard --auth-choice clawrouter-api-keyopenclaw plugins enable clawrouterPlugin OpenClaw के साथ बंडल किया गया है। अगर आपका कॉन्फ़िगरेशन
plugins.allow सेट करता है, तो इसे सक्षम करने से पहले उस सूची में clawrouter जोड़ें। कस्टम
डिप्लॉयमेंट के लिए, models.providers.clawrouter.baseUrl को
ClawRouter origin पर सेट करें; डिफ़ॉल्ट https://clawrouter.openclaw.ai है।
List granted models
openclaw models list --all --provider clawrouterलौटाए गए मॉडल refs का ठीक उसी तरह उपयोग करें जैसे दिखाए गए हैं। वे अपस्ट्रीम
namespace बनाए रखते हैं, जैसे clawrouter/openai/..., clawrouter/anthropic/..., या
clawrouter/google/...। अगर आपके कॉन्फ़िगरेशन में agents.defaults.models एक allowlist है,
तो हर चुने गए ClawRouter ref को उसमें जोड़ें।
Select a model
openclaw models set clawrouter/<provider>/<model>आप एक रन के लिए लौटाए गए मॉडल को
openclaw agent --model clawrouter/<provider>/<model> --message "..." से भी चुन सकते हैं।
मॉडल खोज
GET /v1/catalog सत्य का स्रोत है। OpenClaw, ClawRouter मॉडलों की कोई दूसरी,
स्थिर सूची शिप नहीं करता। ClawRouter में कॉन्फ़िगर किया गया मॉडल तब दिखाई देता है जब:
- क्रेडेंशियल की नीति उसके प्रदाता को अनुमति देती है;
- प्रदाता कनेक्शन सक्षम और तैयार है;
- कैटलॉग मॉडल समर्थित LLM क्षमता का विज्ञापन करता है; और
- कैटलॉग ऐसा transport contract दिखाता है जिसे Plugin समर्थन देता है।
इसलिए समर्थित ClawRouter प्रदाता में कोई और मॉडल जोड़ने के लिए OpenClaw रिलीज़ या किसी दूसरे प्रदाता Plugin की ज़रूरत नहीं होती। अगला कैटलॉग refresh उसे खोज लेता है। जिस मॉडल को नए wire protocol की ज़रूरत है, उसे OpenClaw द्वारा विज्ञापित करने से पहले ClawRouter Plugin में समर्थन चाहिए।
प्रोटोकॉल और प्रदाता Plugins
आपको हर अपस्ट्रीम कंपनी का auth Plugin इंस्टॉल करने की ज़रूरत नहीं है। ClawRouter अपस्ट्रीम क्रेडेंशियल का स्वामी है; उसका कैटलॉग OpenClaw को बताता है कि कौन-सा transport उपयोग करना है। Plugin इसका समर्थन करता है:
| कैटलॉग route | OpenClaw transport |
|---|---|
| OpenAI-संगत चैट | openai-completions |
| OpenAI-संगत Responses | openai-responses |
| नेटिव Anthropic Messages | anthropic-messages |
| नेटिव Google Gemini streaming | google-generative-ai |
Plugin उन परिवारों के लिए मेल खाती replay और tool-schema नीतियां भी लागू करता है। किसी दूसरे request/stream फ़ॉर्मैट का उपयोग करने वाली कैटलॉग पंक्तियों को जानबूझकर OpenClaw text models के रूप में विज्ञापित नहीं किया जाता। असंगत payload भेजने के बजाय उन प्रदाताओं को ClawRouter में समर्थित contracts में से किसी एक पर normalize करें।
कोटा और उपयोग
ClawRouter का /v1/usage response सामान्य OpenClaw provider-usage
सतहों को फ़ीड करता है। /status और संबंधित dashboard status, कुंजी की सीमा होने पर मासिक बजट window,
साथ ही request, token और spend totals दिखाते हैं। Unmetered कुंजियां
बिना percentage window के भी कुल उपयोग दिखाती हैं।
Quota lookup, model discovery जैसी ही scoped key का उपयोग करता है। असफल quota lookup model execution को block नहीं करता।
लाइव snapshot देखें:
openclaw status --usageopenclaw models statusवही provider snapshot चैट में /status और OpenClaw के
usage UI के लिए उपलब्ध है। बजट policy-wide होता है, इसलिए उसी
ClawRouter policy का उपयोग करने वाले किसी दूसरे client द्वारा किए गए requests शेष percentage बदल सकते हैं।
समस्या निवारण
| लक्षण | जांचें |
|---|---|
| कोई ClawRouter मॉडल नहीं | पुष्टि करें कि Plugin enabled है और plugins.allow द्वारा allowed है, फिर जांचें कि credential active है और कम से कम एक ready provider grant करता है। |
| कॉन्फ़िगर किया गया ClawRouter मॉडल गायब है | उसकी /v1/catalog capability और route format निरीक्षण करें। Unsupported transport contracts जानबूझकर filtered होते हैं। |
Unknown model: clawrouter/... |
जब उस configuration map का allowlist के रूप में उपयोग हो रहा हो, तो exact catalog ref को agents.defaults.models में जोड़ें। |
catalog या usage से 401 या 403 |
ClawRouter credential को फिर से जारी करें या फिर से scope करें; OpenClaw upstream provider keys पर fall back नहीं करता। |
| discovery के बाद model call fail होता है | ClawRouter में provider connection और upstream health जांचें, फिर उसकी readiness state recover होने के बाद retry करें। |
| Usage में totals हैं लेकिन percentage नहीं | policy unmetered है; percentage window expose करने के लिए ClawRouter में monthly budget जोड़ें। |
सुरक्षा व्यवहार
- Catalog discovery configured proxy key तक scoped है और per key cached है।
- Proxy key केवल request dispatch पर attached होती है; यह model metadata में stored नहीं होती।
- Native Anthropic और Gemini model ids केवल dispatch पर उनके upstream ids में rewritten होते हैं।
- Unsupported या ungranted catalog rows fail closed होते हैं और selectable नहीं होते।
