और चीनी मॉडल और कस्टम प्रॉक्सी एंडपॉइंट
चीनी मॉडल समर्पित पृष्ठ यहाँ समाप्ति पर पहुँच रहा है: DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, Hunyuan, Qianfan सभी के आधिकारिक प्लगइन हैं, जिन्हें पिछले पाठों में कनेक्ट किया जा चुका है। यह पाठ बाकी तीन बातें सुलझाता है — जिनके पास अभी आधिकारिक प्लगइन हैं: StepFun, Xiaomi MiMo, Meituan LongCat; जिन मॉडलों के पास आधिकारिक provider नहीं है जैसे Spark, Baichuan उनका क्या करें; और OpenClaw प्रॉक्सी का सार्वत्रिक समाधान: custom-api-key कस्टम एंडपॉइंट, साथ ही OpenRouter, LiteLLM, ClawRouter तीन एग्रीगेशन रूट। पूरी प्रक्रिया में लगभग 10 मिनट लगते हैं, यह ट्यूटोरियल v2026.10.9 पर आधारित है।
सीखने के बाद आप क्या कर सकते हैं
- StepFun, Xiaomi MiMo, Meituan LongCat तीनों आधिकारिक प्लगइन इंस्टॉल करके उनके डिफ़ॉल्ट मॉडल चलाना
- पहचानना कि किन चीनी मॉडलों के पास कोई आधिकारिक provider नहीं है (Spark, Baichuan, Lingyi Yi, SenseTime), ताकि प्लगइन ढूँढने में समय बर्बाद न हो
custom-api-keyप्रक्रिया से कोई भी OpenAI-संगत प्रॉक्सी एंडपॉइंट OpenClaw में जोड़ना — onboarding और कॉन्फ़िगरेशन फ़ाइल दोनों तरीके- OpenRouter / LiteLLM / ClawRouter तीन प्रकार के एग्रीगेशन रूट कनेक्ट करना, एक Key से कई मॉडल उपयोग करना
- प्रॉक्सी एंडपॉइंट के संगतता स्विच समायोजित करना जानना:
reasoning_effortपर 400 एरर आना, इंट्रानेट एंडपॉइंट का अस्वीकृत होना, वेंडर के प्राइवेट फ़ील्ड का पास-थ्रू
🎒 शुरू करने से पहले की तैयारी
- पूरा किया है मॉडल कनेक्शन ओवरव्यू: provider सिस्टम और मॉडल स्विचिंग: «प्लगइन इंस्टॉल करें → क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें» तीन चरण और
provider/modelरेफ़रेंस नियम से भली-भाँति परिचित - OpenClaw इंस्टॉल है, Gateway चल रहा है:
openclaw gateway statusका आउटपुट मिल रहा है - जो कनेक्ट करना है उसके क्रेडेंशियल आपके पास हैं: वेंडर की API Key, या प्रॉक्सी स्टेशन द्वारा दिया गया baseUrl + API Key
- सर्वर / डेमन परिनियोजन का उपयोग कर रहे हैं तो पता हो कि
~/.openclaw/.envकहाँ है — Key अंततः वहीं रहेगी
मेरे साथ करें
चरण 1: रूट चुनें — आधिकारिक प्लगइन, कस्टम एंडपॉइंट या एग्रीगेशन रूट
क्यों: OpenClaw में मॉडल कनेक्ट करने के तीन रास्ते हैं, गलत चुनने पर मेहनत बेकार जाएगी — पहले 30 सेकंड लगाकर अपनी जगह पहचानें।
| आपकी स्थिति | कौन-सा रास्ता | इस पाठ में किस चरण पर |
|---|---|---|
| StepFun / Xiaomi MiMo / Meituan LongCat उपयोग करना | आधिकारिक प्लगइन (बाहरी, इंस्टॉल करना होगा) | चरण 2 |
| Spark, Baichuan, Lingyi Yi, SenseTime उपयोग करना — वेंडर OpenAI-संगत API देता है | कस्टम एंडपॉइंट custom-api-key | चरण 3 |
| पास में प्रॉक्सी स्टेशन है (baseUrl + Key देने वाला OpenAI-संगत प्रॉक्सी) | कस्टम एंडपॉइंट custom-api-key | चरण 3 |
| एक Key से कई मॉडल / टीम का एकीकृत गेटवे चाहिए | एग्रीगेशन रूट | चरण 4 |
पहले एक नकारात्मक परिणाम बता दें (आधिकारिक रिपॉज़िटरी 2026-11-03 की पूरी जाँच): iFlytek Spark, Baichuan, Lingyiwanwu Yi, SenseTime SenseChat का OpenClaw में कोई आधिकारिक provider प्लगइन नहीं है — extensions/ और docs/providers/ दोनों में संबंधित कैटलॉग नहीं मिलते। SenseTime का SenseAudio ज़रूर पहले से शामिल प्लगइन है, लेकिन वह स्पीच-टू-टेक्स्ट सेवा है, SenseChat लार्ज मॉडल नहीं। इसलिए «Spark प्लगइन» मत ढूँढिए — ये तीनों केवल चरण 3 के कस्टम एंडपॉइंट या चरण 4 के एग्रीगेशन रूट से जा सकते हैं।
चरण 2: StepFun, Xiaomi MiMo, Meituan LongCat कनेक्ट करना (आधिकारिक प्लगइन तिकड़ी)
क्यों: ये तीनों चीनी मॉडल आधिकारिक प्लगइन की आख़िरी तीन सीटें हैं (Volcano का इंटरनेशनल संस्करण BytePlus Doubao पाठ में बताया गया है), इंस्टॉल करने का तरीका DeepSeek जैसा ही है — प्लगइन इंस्टॉल करें, Key कॉन्फ़िगर करें, मॉडल चुनें।
पहले सारांश तालिका देखें (सारी जानकारी आधिकारिक provider दस्तावेज़ से):
| वेंडर | प्लगइन पैकेज (बाहरी, इंस्टॉल करना होगा) | provider id | एनवायरनमेंट वेरिएबल | डिफ़ॉल्ट मॉडल |
|---|---|---|---|---|
| 阶跃星辰 StepFun | @openclaw/stepfun-provider | stepfun, stepfun-plan | STEPFUN_API_KEY | stepfun/step-3.5-flash |
| Xiaomi MiMo | @openclaw/xiaomi-provider | xiaomi, xiaomi-token-plan | XIAOMI_API_KEY, XIAOMI_TOKEN_PLAN_API_KEY | xiaomi/mimo-v2.6-pro |
| Meituan LongCat | @openclaw/longcat-provider | longcat | LONGCAT_API_KEY | longcat/LongCat-2.0 |
StepFun: पहले China Key और International Key के बीच अंतर समझें
StepFun की Keys क्षेत्र (region) के अनुसार बंटी हैं, आधिकारिक दस्तावेज़ स्पष्ट रूप से मांग करते हैं: China Key के साथ .com endpoint और International Key के साथ .ai endpoint उपयोग करें, इन्हें मिलाकर न चलाएँ।
openclaw plugins install @openclaw/stepfun-provider
openclaw onboard --auth-choice stepfun-standard-api-key-cn # 中国 Key → api.stepfun.com
openclaw onboard --auth-choice stepfun-standard-api-key-intl # 国际 Key → api.stepfun.aiआपको यह दिखना चाहिए: onboarding संकेत STEPFUN_API_KEY पेस्ट करने को कहता है, सत्यापन पास होने के बाद डिफ़ॉल्ट मॉडल stepfun/step-3.5-flash हो जाता है।
स्टैंडर्ड endpoint मॉडल सूची:
| मॉडल संदर्भ | संदर्भ (context) | अधिकतम आउटपुट | टिप्पणी |
|---|---|---|---|
stepfun/step-3.5-flash | 262,144 | 65,536 | डिफ़ॉल्ट मॉडल |
stepfun/step-3.7-flash | 262,144 | 262,144 | मल्टीमॉडल, इमेज इनपुट समर्थित |
एक अलग Step Plan endpoint भी है (स्वतंत्र provider, संदर्भ प्रीफ़िक्स stepfun-plan/..., auth-choice है stepfun-plan-api-key-cn|intl), जैसे मॉडल stepfun-plan/step-3.5-flash-2603। Step 3.7 low / medium / high तीन effort स्तरों को समर्थन देता है, कोई नॉन-रीज़निंग मोड नहीं है, /think off low पर मैप हो जाता है।
Xiaomi MiMo: पे-एज़-यूज़ और Token Plan दो providers
openclaw plugins install @openclaw/xiaomi-provider
openclaw onboard --auth-choice xiaomi-api-key # 按量付费,sk-... Key
openclaw onboard --auth-choice xiaomi-token-plan-sgp # Token Plan,tp-... Key(区域可选 cn / sgp / ams)पे-एज़-यूज़ Key Xiaomi MiMo कंसोल में बनती है: platform.xiaomimimo.com/#/console/api-keys; Token Plan के लिए सब्सक्रिप्शन पेज से क्षेत्रीय endpoint और संगत tp-... Key कॉपी करें।
मॉडल एक नज़र में: mimo-v2.6-pro (डिफ़ॉल्ट), mimo-v2.6-flash, mimo-v2.6-pro-ultraspeed (आधिकारिक सूची में 20x आउटपुट गति अंकित), mimo-v2.5, mimo-v2.5-pro — सभी का context 1,048,576 token है। /think सभी स्तरों को समर्थन देता है (off से max, डिफ़ॉल्ट high)। इस प्लगइन में TTS भी है (mimo-v2.5-tts), अगर आप Claw को आवाज़ देना चाहते हैं तोइमेज और वॉइस वाला पाठ देखें।
Meituan LongCat: एक मॉडल, रीज़निंग पर केंद्रित
openclaw plugins install @openclaw/longcat-provider
openclaw onboard --auth-choice longcat-api-keyKey LongCat API प्लेटफ़ॉर्म पर बनती है: longcat.chat/platform/api_keys।
केवल एक ही मॉडल है: longcat/LongCat-2.0 — 1,048,576 context / 131,072 अधिकतम आउटपुट, केवल टेक्स्ट इनपुट, आधिकारिक पोज़िशनिंग है "coding और agentic वर्कलोड के लिए बनाया गया रीज़निंग मॉडल"। कीमत (आधिकारिक दस्तावेज़ के अनुसार, प्रति मिलियन token): इनपुट $0.75 (अनकैश्ड) / $0.015 (कैश हिट), आउटपुट $2.95।
💡 LongCat के ओपन-सोर्स वेट्स को लोकली चलाना चाहते हैं?
longcat/LongCat-2.0 इस संदर्भ का उपयोग लोकल डिप्लॉयमेंट से जुड़ने के लिए न करें — यह होस्टेड API की ओर इशारा करता है। ओपन-सोर्स वेट्स लोकली चलाने के लिए vLLM / SGLang उपयोग करें, अगला पाठ देखें लोकल मॉडल: Ollama, vLLM और ds4।
- जिस provider को इंस्टॉल किया है,
openclaw models list --provider stepfun(याxiaomi/longcat) उसकी मॉडल सूची दिखा देगा
चरण 3: OpenClaw में relay endpoint कॉन्फ़िगर करना — custom-api-key सामान्य प्रक्रिया
क्यों: Spark, Baichuan, Lingyi, SenseTime के आधिकारिक प्लगइन नहीं हैं; बाज़ार के "रिले स्टेशन" और "API प्रॉक्सी" भी अपनी-अपनी प्राइवेट डिप्लॉयमेंट हैं। लेकिन जब तक वे आपको एक OpenAI-संगत baseUrl + API Key देते हैं, OpenClaw custom-api-key प्रक्रिया से जुड़ सकता है — यही इस पाठ की केंद्रीय विधि है।
विधि A (अनुशंसित): onboarding की एक ही कमांड
नॉन-इंटरैक्टिव फुल-पैरामीटर संस्करण (पैरामीटर आधिकारिक दस्तावेज़ उदाहरण से लिए गए हैं, $CUSTOM_API_KEY का पहले से एनवायरनमेंट में सेट होना ज़रूरी है):
openclaw onboard --non-interactive --accept-risk --skip-health \
--auth-choice custom-api-key \
--custom-base-url "https://llm.example.com/v1" \
--custom-model-id "foo-large" \
--custom-api-key "$CUSTOM_API_KEY" \
--custom-compatibility openaiपाँचों पैरामीटर अपना-अपना एक काम करते हैं:
| पैरामीटर | कार्य | सावधानी |
|---|---|---|
--custom-base-url | रिले स्टेशन का पता | OpenAI-संगत endpoint में आमतौर पर /v1 जोड़ना होता है, नुकसान से बचने की चेतावनी देखें |
--custom-model-id | मॉडल ID | छोड़ा जा सकता है: छोड़ने पर endpoint के /models से ऑटो-डिस्कवरी होती है (5 सेकंड टाइमआउट), खोजे गए सभी मॉडल सहेजे जाते हैं, पहला डिफ़ॉल्ट बनता है; खोज विफल हो तो दोबारा चलाएँ और स्पष्ट रूप से निर्दिष्ट करें |
--custom-api-key | API Key | छोड़ने पर एनवायरनमेंट वेरिएबल CUSTOM_API_KEY पढ़ा जाता है |
--custom-compatibility | प्रोटोकॉल स्वरूप | openai (डिफ़ॉल्ट, chat completions) / openai-responses (केवल /v1/responses endpoint) / anthropic; anthropic के लिए ज़रूरी है --custom-model-id |
--custom-image-input / --custom-text-input | इनपुट प्रकार | सामान्य विज़न मॉडल ID (GPT-4o/4.1/5.x, Claude 3/4, Gemini, Qwen-VL, LLaVA, Pixtral आदि) स्वतः इमेज इनपुट अंकित होते हैं; सूची में न होने वाले विज़न मॉडलों के लिए पहले वाले से मजबूरन अंकित करें |
आपको यह दिखना चाहिए: कमांड बिना किसी त्रुटि के पूरी होती है; openclaw models status में एक कस्टम provider जुड़ जाता है, डिफ़ॉल्ट मॉडल आपके दिए गए ID की ओर इशारा करता है।
पैरामीटर याद नहीं रखना चाहते? इंटरैक्टिव रूप से openclaw onboard चलाएँ, Custom setup चुनकर सभी गाइड विकल्पों से गुज़रें, आप वही चीज़ें भरते हैं।
⚠️ Gateway को डेमन की तरह चला रहे हैं? Key को इंटरैक्टिव shell में न रखें
Gateway जब launchd / systemd सेवा के रूप में चलता है, तो वह आपके टर्मिनल में export के एनवायरनमेंट वेरिएबल नहीं देख पाता। Key को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv के ज़रिए उस प्रोसेस को दें।
विधि B: कॉन्फ़िगरेशन फ़ाइल मैन्युअल रूप से बदलें
पसंद है कि सब कुछ आपके नियंत्रण में हो, या कई मशीनों पर कॉन्फ़िगरेशन बैच में रोल करना हो——models.providers हाथ से लिखें। बिना प्रमाणीकरण वाले एंडपॉइंट का आधिकारिक उदाहरण (जस का तस):
{
agents: {
defaults: { model: { primary: "my-studio/qwen3.8" } },
},
models: {
providers: {
"my-studio": {
baseUrl: "https://studio.example.ts.net/v1",
api: "openai-completions",
auth: "none",
models: [{ id: "qwen3.8", name: "Qwen3.8" }],
},
},
},
}Key के साथ, पूर्ण मॉडल मेटाडेटा के साथ लिखने का तरीका (आधिकारिक उदाहरण का जस का तस अंश):
{
agents: {
defaults: {
model: { primary: "lmstudio/my-local-model" },
models: { "lmstudio/my-local-model": { alias: "Local" } },
},
},
models: {
providers: {
lmstudio: {
baseUrl: "http://localhost:1234/v1",
apiKey: "${LM_API_TOKEN}",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "my-local-model",
name: "Local Model",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 200000,
maxTokens: 8192,
},
],
},
},
},
}मॉडल फ़ील्ड छोड़ी जा सकती हैं; छोड़ने पर डिफ़ॉल्ट मान: reasoning: false, input: ["text"], cost सभी 0, contextWindow न सेट करने पर 200000 के रूप में फ़ॉलबैक होता है। आधिकारिक सलाह: अपने प्रॉक्सी / मॉडल की वास्तविक सीमाओं के अनुसार सब कुछ स्पष्ट रूप से पूरा लिखें।
बिना प्रमाणीकरण वाला एंडपॉइंट: auth: "none"
इंट्रानेट पर सेल्फ़-होस्टेड, tailnet / VPN पर चलने वाली inference सेवाओं में अक्सर Key नहीं होती। OpenClaw समर्थन करता है, लेकिन दो कड़े नियम हैं:
- स्पष्ट रूप से
auth: "none"घोषित करें (onboarding के लिए संबंधित--custom-no-authहै, इसे--custom-api-keyके साथ उपयोग नहीं किया जा सकता)——स्वचालित बिना-प्रमाणीकरण डिटेक्शन केवल loopback और RFC1918 पतों को कवर करता है; tailnet / VPN जैसे 「प्राइवेट नेटवर्क लेकिन RFC1918 नहीं」 को स्पष्ट रूप से घोषित करना ज़रूरी है auth: "none"केवलopenai-completionsएडेप्टर पर लागू होता है; Responses, Azure OpenAI, Anthropic संगत एंडपॉइंट पर बिना प्रमाणीकरण होने पर भी एक प्लेसहोल्डर Key रखें
मध्यस्थ (relay) एंडपॉइंट का संगतता स्विच (compat)
OpenClaw 「baseUrl, api.openai.com न होने वाले openai-completions एंडपॉइंट」 पर स्वचालित रूप से एक सतर्कतापूर्ण ट्रिमिंग लेयर लागू करता है, ताकि मध्यस्थ सेवा OpenAI-विशिष्ट फ़ील्ड से भरकर न फटे। स्वचालित नियम और मैनुअल स्विच की तुलना:
| लक्षण / आवश्यकता | स्विच |
|---|---|
मध्यस्थ सेवा developer रोल नहीं पहचानती | स्वचालित: गैर-नेटिव एंडपॉइंट पर compat.supportsDeveloperRole: false बाध्यकारी (स्पष्ट रूप से true लिखने पर भी ओवरराइड हो जाएगा) |
400 एरर: reasoning_effort नहीं पहचानता | उस मॉडल पर compat.supportsReasoningEffort: false सेट करें (reasoning: true के कस्टम मॉडल पर thinking चालू होने पर डिफ़ॉल्ट रूप से यह फ़ील्ड भेजी जाती है) |
thinking सत्र reasoning_content का रिप्ले मांगता है | compat.requiresReasoningContentOnAssistantMessages: true सेट करें (रिप्ले फ़ील्ड के नाम reasoning / reasoning_text / reasoning_content डिफ़ॉल्ट रूप से जस के तस रहते हैं) |
| वेंडर के प्राइवेट फ़ील्ड पास-थ्रू करना है | agents.defaults.models["provider/model"].params.extra_body (या extraBody), अनुरोध बॉडी में मर्ज होता है |
| LAN / tailnet एंडपॉइंट अस्वीकृत | models.providers.<id>.request.allowPrivateNetwork: true (loopback डिफ़ॉल्ट रूप से अनुमत) |
| धीमे एंडपॉइंट बार-बार टाइमआउट | models.providers.<id>.timeoutSeconds |
| Anthropic संगत मध्यस्थ beta हेडर नहीं पहचानता | स्वचालित: इम्प्लिसिट beta headers दबा दिए जाते हैं (जैसे claude-code-20250219); beta सुविधा वास्तव में चाहिए तो models.providers.<id>.headers["anthropic-beta"] में स्पष्ट रूप से घोषित करें |
openclaw models statusकस्टम provider के क्रेडेंशियल स्रोत दिखा सकता है; एंडपॉइंट पताopenclaw config get models.providers.<id>.baseUrlसे देखें
चरण 4: एग्रीगेट राउटिंग में से एक चुनें——OpenRouter, LiteLLM, ClawRouter
क्यों: हर मॉडल वेंडर के लिए अलग से रजिस्टर नहीं करना चाहते? एग्रीगेट राउटिंग आपको एक Key, कई वेंडर के मॉडल देती है। तीनों प्लगइन OpenClaw में पहले से शामिल हैं (included in OpenClaw), पहले इंस्टॉल करने की ज़रूरत नहीं।
| राउटर | क्या है | प्रमाणीकरण | डिफ़ॉल्ट पता / मॉडल |
|---|---|---|---|
| OpenRouter | व्यावसायिक एग्रीगेट सेवा, एक Key से कई वेंडर के मॉडल | OAuth या API Key | डिफ़ॉल्ट मॉडल openrouter/auto |
| LiteLLM | ओपन-सोर्स सेल्फ़-होस्टेड LLM गेटवे (100+ provider) | अपनी ही Key प्रॉक्सी करता है | डिफ़ॉल्ट प्रॉक्सी http://localhost:4000 |
| ClawRouter | OpenClaw आधिकारिक होस्टेड मल्टी-अपस्ट्रीम राउटर | एडमिन द्वारा जारी policy-scoped Key | https://clawrouter.openclaw.ai |
OpenRouter: एक Key से घरेलू + विदेशी मॉडल
बिल्ट-इन starter कैटलॉग में घरेलू मॉडल पहले से मौजूद हैं: openrouter/moonshotai/kimi-k2.6, openrouter/moonshotai/kimi-k2.5; अन्य संदर्भ openrouter/<provider>/<model> की तरह होते हैं, जो OpenRouter के आधिकारिक कैटलॉग को डायनामिक रूप से रिज़ॉल्व करते हैं। OpenRouter के ज़रिए DeepSeek V4 कॉल करते समय, OpenClaw स्वचालित रूप से reasoning_content रिप्ले जोड़ता है, thinking सत्र टूटता नहीं।
# 方式一:API Key(在 openrouter.ai/keys 创建)
openclaw onboard --auth-choice openrouter-api-key
# 方式二:聊天里直接 OAuth(私聊发送,浏览器登录授权)
/login openrouterआपको यह दिखना चाहिए: सत्यापन के बाद डिफ़ॉल्ट मॉडल openrouter/auto होगा। कोई विशिष्ट मॉडल लॉक करना चाहें तो: openclaw models set openrouter/moonshotai/kimi-k2.6।
LiteLLM: सेल्फ़-होस्टेड एकीकृत गेटवे, कॉस्ट अकाउंटिंग
LiteLLM एक ओपन-सोर्स LLM गेटवे है, जो 100+ provider को एकीकृत API से जोड़ता है, साथ में कॉस्ट ट्रैकिंग, लॉगिंग, लिमिटेड वर्चुअल Key और बैकएंड फ़ेलओवर। OpenClaw इसके OpenAI-संगत /v1 से जुड़ता है:
openclaw onboard --auth-choice litellm-api-key
# 提示代理地址时回车用默认 http://localhost:4000,或填你的代理 URLरिमोट प्रॉक्सी का नॉन-इंटरैक्टिव संस्करण (आधिकारिक दस्तावेज़ जस का तस):
openclaw onboard --non-interactive --accept-risk --skip-health --auth-choice litellm-api-key \
--litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"onboarding प्रॉक्सी के /v1/models से मॉडल खोजता है और पहले को डिफ़ॉल्ट बनाता है; खोज विफल होने पर आपको ID मैनुअल रूप से भरने का संकेत मिलेगा। LAN में LiteLLM प्रॉक्सी पर request.allowPrivateNetwork: true जोड़ना न भूलें। अलग-अलग लोगों को लिमिटेड Key देने के लिए LiteLLM का POST /key/generate उपयोग करें (max_budget / budget_duration)।
ClawRouter: आधिकारिक होस्टेड, क्रेडेंशियल घर से बाहर नहीं जाते
ClawRouter, OpenClaw का आधिकारिक होस्टेड मल्टी-अपस्ट्रीम राउटर है: अपस्ट्रीम वेंडरों के क्रेडेंशियल और फ़ॉरवर्डिंग सब ClawRouter की ओर रहते हैं, आपकी OpenClaw मशीन परकिसी भी अपस्ट्रीम provider प्लगइन इंस्टॉल करने की ज़रूरत नहीं। प्लगइन बिल्ट-इन और डिफ़ॉल्ट रूप से सक्रिय है, आपको बस एडमिन द्वारा जारी Key चाहिए (जारी होते समय एक बार दिखती है, संभालकर रखें)।
export CLAWROUTER_API_KEY="..."
openclaw onboard --auth-choice clawrouter-api-key
openclaw plugins enable clawrouter
openclaw models list --all --provider clawrouter(clawrouter पहले से ही डिफ़ॉल्ट रूप से सक्रिय है; केवल तब पहले इसे अनुमत सूची में जोड़ना होगा जब कॉन्फ़िगरेशन में plugins.allow सेट किया गया हो।)
मॉडल संदर्भ अपस्ट्रीम नेमस्पेस बनाए रखते हैं, तीन-भाग वाले रूप में: clawrouter/openai/gpt-5.5, clawrouter/anthropic/claude-sonnet-4-6, clawrouter/google/gemini-3.5-flash——कैटलॉग से लौटाए गए नाम जस के तस उपयोग करें, openclaw models set clawrouter/<provider>/<model>। कैटलॉग Key की अनुमति स्कोप के अनुसार /v1/catalog से खोजा जाता है (1 घंटे कैश), कोटा /v1/usage से चलता है।
चरण 5: मध्यस्थ लिंक सत्यापित करें
क्यों: कॉन्फ़िगरेशन डिस्क पर लिख देना इस बात की गारंटी नहीं कि लिंक काम करेगा। कैटलॉग, क्रेडेंशियल और एंड-टू-एंड संवाद, तीनों की अलग-अलग जाँच करें, ताकि कोई भी परत टूटे तो पता हो कि कहाँ ठीक करना है——यह चरण आधिकारिक प्लगइन और कस्टम मध्यस्थ एंडपॉइंट दोनों पर लागू होता है।
# 1. 看目录:新接入的 provider 和模型有没有进来
openclaw models list
# 2. 看凭据:默认模型、fallback,以及各 provider 的凭据来源
openclaw models status
# 3. 发一条测试消息,确认端到端连通
openclaw agent --agent <agent-id> --model <provider/model> --message "用一句话介绍你自己"कमांड 3 टर्मिनल से एक पूर्ण agent turn चलाती है (Gateway से होकर फ़ॉरवर्ड)। ध्यान दें कि openclaw agent में कम से कम एक सत्र चयनकर्ता होना चाहिए: --agent, --to, --session-key या --session-id, सबसे अधिक उपयोग --agent <id>; --model provider/model संदर्भ स्वीकार करता है, केवल इसी turn पर लागू होता है, सत्र का डिफ़ॉल्ट मान नहीं बदलता।
आपको यह दिखना चाहिए:
models list: डायरेक्टरी में आपका अभी-अभी जोड़ा गया provider और मॉडल दिखते हैं — कस्टम एंडपॉइंट पर onboarding में सेव किया गया मॉडल ID दिखता है (ऑटो-डिस्कवरी/modelsसे लौटाए गए सभी मॉडलों को सेव कर लेती है)models status: डिफ़ॉल्ट मॉडल आपके चुने हुए मॉडल की ओर इशारा करता है, कस्टम provider का क्रेडेंशियल स्रोत सामान्य दिखता है; "Unavailable auth profiles" जैसा कोई शब्द नहीं है (अगर हो, तो एंट्री के साथ कारण और रिकवरी एक्शन दिखेगा, उसी के अनुसार करें)। एंडपॉइंट पता जांचना हो तो:openclaw config get models.providers.<id>.baseUrlagent: मॉडल आपको एक जवाब देता है, कमांड का एग्जिट कोड 0 होता है — एरर, टाइमआउट, रद्दीकरण सभी पर एग्जिट 1। रिले लिंक एंड-टू-एंड जुड़ गया
टेस्ट पास होने के बाद, जो मॉडल सुविधाजनक लगे उसे रोज़मर्रा का डिफ़ॉल्ट बना दें:
openclaw models set <provider/model>- टेस्ट संदेश का जवाब आता है,
openclaw agentका एग्जिट कोड 0 — रिले लिंक एंड-टू-एंड जुड़ गया
चेकपॉइंट ✅
- जिसका इस्तेमाल करना है वही इंस्टॉल करें:
openclaw models list --provider stepfun(याxiaomi/longcat) मॉडल डायरेक्टरी लिस्ट कर सकता है - निगेटिव नतीजे याद रखें: Spark, Baichuan, लिंग्यी Yi, SenseTime SenseChat का कोई ऑफिशियल provider नहीं है — सीधे
custom-api-keyकस्टम एंडपॉइंट या एग्रीगेट रूटिंग से जाएं, प्लगइन खोजने में समय बर्बाद न करें - कस्टम एंडपॉइंट जुड़ गया:
openclaw models statusसे उस provider का क्रेडेंशियल स्रोत दिखता है,openclaw config get models.providers.<id>.baseUrlसे एंडपॉइंट पता मिलता है openclaw agentटेस्ट संदेश का जवाब आता है, एग्जिट कोड 0 — OpenClaw रिले लिंक एंड-टू-एंड जुड़ गया- कम्पैटिबिलिटी समस्या आने पर कहां देखना है पता है: चरण 3 का compat स्विच टेबल (
reasoning_effortपर 400, इंट्रानेट एंडपॉइंट का रिजेक्ट होना, वेंडर के प्राइवेट फ़ील्ड का पास-थ्रू)
आम गलतियों की चेतावनी
❌ baseUrl में /v1 की कमी, सभी रिक्वेस्ट 404
OpenAI-कम्पैटिबल एंडपॉइंट का baseUrl आमतौर पर .../v1 तक लिखना होता है: मॉडल डिस्कवरी <baseUrl>/models रिक्वेस्ट करती है (ऑफिशियल दस्तावेज़ उदाहरण /v1/models), और चैट रिक्वेस्ट भी baseUrl के बाद जुड़ती है (जैसे /v1/chat/completions)। ऑफिशियल उदाहरणों में baseUrl सभी /v1 पर समाप्त होते हैं। रिले स्टेशन का पता मिलने पर पहले अंत देख लें, संदेह हो तो उसके दस्तावेज़ का "Base URL" जस का तस कॉपी कर दें।
❌ मॉडल ऑटो-डिस्कवरी विफल, या डिफ़ॉल्ट मॉडल वह नहीं जो चाहिए
--custom-model-id छोड़ने पर, onboarding <baseUrl>/models ऑटो-डिस्कवरी रिक्वेस्ट करता है (5 सेकंड टाइमआउट), खोजे गए सभी मॉडल सेव होते हैं, पहला डिफ़ॉल्ट बनता है। एंडपॉइंट अनुपलब्ध होना, अमान्य डेटा लौटाना या खाली लिस्ट — सभी पर विफलता होती है — दोबारा चलाएं और स्पष्ट रूप से --custom-model-id दें। खोजा गया पहला मॉडल उपयुक्त नहीं? दोबारा कॉन्फ़िगर करने की ज़रूरत नहीं, openclaw models set <provider/model> से डिफ़ॉल्ट बदल दें।
❌ StepFun का चीन Key इंटरनेशनल एंडपॉइंट पर कॉन्फ़िगर (या इसका उल्टा)
StepFun के Key क्षेत्र-वार होते हैं: चीन Key के लिए .com एंडपॉइंट, इंटरनेशनल Key के लिए .ai एंडपॉइंट, ऑफिशियल दस्तावेज़ स्पष्ट रूप से मिलाने से मना करते हैं। auth-choice में stepfun-standard-api-key-cn या -intl चुनते ही एंडपॉइंट तय हो जाता है — प्रमाणीकरण विफल होने पर पहले जांचें कि क्षेत्र तो गलत नहीं चुना।
❌ Anthropic-कम्पैटिबल एंडपॉइंट को --custom-model-id नहीं दिया
--custom-compatibility anthropic की सेटिंग में ज़रूरी रूप से --custom-model-id शामिल होना चाहिए — Anthropic-कम्पैटिबल एंडपॉइंट पर मॉडल ऑटो-डिस्कवरी का चरण नहीं होता, इसे छोड़ने पर सीधे विफलता होगी।
❌ auth: "none" काम नहीं करता
दो सख़्त नियम: ① ऑटो नॉ-ऑथ डिटेक्शन केवल loopback और RFC1918 पतों पर लागू होता है, tailnet / VPN पर स्थित एंडपॉइंट के लिए auth: "none" स्पष्ट रूप से घोषित करना ज़रूरी है (onboarding में इसके लिए --custom-no-auth, जिसे --custom-api-key के साथ इस्तेमाल नहीं किया जा सकता); ② auth: "none" केवल openai-completions एडेप्टर पर लागू होता है — Responses, Azure OpenAI, Anthropic-कम्पैटिबल एंडपॉइंट पर भी नॉ-ऑथ होने पर एक प्लेसहोल्डर Key रखना होगा।
❌ Gateway डेमन के रूप में चलने पर, export किया गया Key "काम नहीं करता"
Gateway जब launchd / systemd सर्विस के रूप में चलता है, तो आपके टर्मिनल के export एनवायरनमेंट वेरिएबल उसे दिखाई नहीं देते। Key को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv के ज़रिए उस प्रोसेस को दें (चरण 3 के तरीक़े A के चेतावनी बॉक्स में बताया गया था, यह अक्सर होने वाली गलती है, यहां एक बार फिर याद दिलाते हैं)।
❌ रिले स्टेशन reasoning_effort को नहीं पहचानता, thinking चालू करते ही 400
reasoning: true के कस्टम मॉडल पर thinking चालू होने पर डिफ़ॉल्ट रूप से reasoning_effort फ़ील्ड भेजी जाती है, जिसे कुछ रिले स्टेशन नहीं पहचानते। इस मॉडल के लिए compat.supportsReasoningEffort: false सेट करें। अन्य संगतता समस्याएँ (developer रोल अस्वीकृत होना, प्राइवेट फ़ील्ड पास-थ्रू होना, इंट्रानेट एंडपॉइंट अस्वीकृत होना) चरण 3 के compat स्विच तालिका में देखें।
❌ रिले स्टेशन का बैलेंस अपर्याप्त / बिलिंग सही से कॉन्फ़िगर नहीं
लिंक का कॉन्फ़िगरेशन पूरा सही होने पर भी बिलिंग पर गिरना संभव है: रिले स्टेशन का बैलेंस अपर्याप्त हो, बंधा मॉडल एक्टिवेट न हो — रिक्वेस्ट विफल होगी। OpenClaw के अपने लाइवनेस चेक का उपयोग करना चाहें तो: openclaw models status --probe कॉन्फ़िगर किए गए क्रेडेंशियल पर वास्तविक रिक्वेस्ट भेजता है (token खर्च हो सकते हैं, रेट लिमिट ट्रिगर हो सकता है), बिलिंग-प्रकार की विफलताएं billing स्टेटस बकेट में जाती हैं; ध्यान दें कि इसे स्टेटस डायरेक्टरी पर एक्सक्लूसिव एक्सेस चाहिए, पहले openclaw gateway stop से Gateway रोकें फिर चलाएं। रोज़मर्रा की जांच में पहले रिले स्टेशन के बैकएंड पर बैलेंस और मॉडल एक्टिवेशन स्टेटस देखें, वह ज़्यादा सीधा तरीक़ा है।
अगला कदम
घरेलू मॉडल समर्पित पृष्ठ यहीं समाप्त: ऑफिशियल प्लगइन (DeepSeek, Qwen, GLM, Kimi, MiniMax, Doubao, Hunyuan, Qianfan, StepFun, MiMo, LongCat), कस्टम एंडपॉइंट, एग्रीगेट रूटिंग — तीनों रास्ते आपने पार कर लिए। OpenClaw रिले का सार्वभौमिक समाधान एक वाक्य याद रखें: ऑफिशियल प्लगइन हो तो प्लगइन लगाएं, ऑफिशियल provider न हो तो custom-api-key, एक Key से कई प्रदाता चाहिए तो एग्रीगेट रूटिंग अपनाएं। आगे:
- अगला पाठ लोकल मॉडल: Ollama, vLLM और ds4: बिल्कुल नेटवर्क पर न जाने वाला, API खर्च रहित लोकल इन्फ़ेरेंस — LongCat के ओपन-सोर्स वेट लोकल चलाना भी इसी पाठ में
- अन्य मॉडल पृष्ठ मॉडल कनेक्शन ओवरव्यू: provider सिस्टम और मॉडल स्विचिंग के कोर्स टेबल से देखें
- मॉडल सब कॉन्फ़िगर हो गए? रोज़मर्रा का उपयोग रोज़मर्रा का उपयोग: अपने Claw के साथ कुशलता से काम से शुरू करें — Control UI, चैट कमांड, मेमोरी सिस्टम सब उसी अध्याय में
संबंधित ट्यूटोरियल
- DeepSeek कनेक्शन: V4 सीरीज़ मॉडल कॉन्फ़िगरेशन व्यवहार — ऑफिशियल प्लगइन कनेक्शन का मानक तरीक़ा, इस पाठ के StepFun / MiMo / LongCat इंस्टॉल इसी स्रोत से हैं
- मॉडल कनेक्शन ओवरव्यू: provider सिस्टम और मॉडल स्विचिंग — "प्लगइन लगाएं → क्रेडेंशियल कॉन्फ़िगर करें → मॉडल चुनें" तीन चरण और
provider/modelरेफ़रेंस नियम - Doubao/Volcengine कनेक्शन: Ark एंडपॉइंट और Coding Plan — Volcengine परिवार का ऑफिशियल प्लगइन, इंटरनेशनल संस्करण BytePlus सहित
- Tencent Hunyuan और Baidu Qianfan कनेक्शन: बड़ी कंपनियों की MaaS व्यवहार — पिछला पाठ: Tencent, Baidu दोनों की MaaS
- इमेज और वॉइस: कंटेंट के लिए इमेज जोड़ना, लेख को वॉइस में बदलना — Xiaomi MiMo प्लगइन में TTS अंतर्निहित है (
mimo-v2.5-tts), वॉइस कॉन्फ़िगर करने के लिए यह पाठ देखें