Skip to main content
LLM/मॉडल प्रदाताओं के लिए संदर्भ (WhatsApp/Telegram जैसे चैट चैनलों के लिए नहीं)। मॉडल चयन नियमों के लिए, मॉडल देखें।

त्वरित नियम

  • मॉडल संदर्भ provider/model का उपयोग करते हैं (उदाहरण: opencode/claude-opus-4-6)।
  • agents.defaults.models उपनाम और प्रति-मॉडल सेटिंग संग्रहीत करता है; agents.defaults.modelPolicy.allow वैकल्पिक स्पष्ट ओवरराइड अनुमतिसूची है।
  • CLI सहायक: openclaw onboard, openclaw models list, openclaw models set <provider/model>
  • models.providers.*.contextWindow / contextTokens / maxTokens प्रदाता-स्तरीय डिफ़ॉल्ट सेट करते हैं; models.providers.*.models[].contextWindow / contextTokens / maxTokens उन्हें प्रति मॉडल ओवरराइड करते हैं।
  • फ़ॉलबैक नियम, कूलडाउन जाँच और सत्र-ओवरराइड स्थायित्व: मॉडल फ़ेलओवर
जब आप किसी प्रदाता को जोड़ते हैं या उसका पुनः प्रमाणीकरण करते हैं, तो openclaw configure मौजूदा agents.defaults.model.primary को बनाए रखता है। जब तक आप --set-default पास नहीं करते, openclaw models auth login भी यही करता है। प्रदाता Plugin अब भी अपने प्रमाणीकरण कॉन्फ़िगरेशन पैच में अनुशंसित डिफ़ॉल्ट मॉडल लौटा सकते हैं, लेकिन यदि कोई प्राथमिक मॉडल पहले से मौजूद है, तो OpenClaw इसे “इस मॉडल को उपलब्ध बनाएँ” मानता है, न कि “वर्तमान प्राथमिक मॉडल को बदलें।”डिफ़ॉल्ट मॉडल को जानबूझकर बदलने के लिए, openclaw models set <provider/model> या openclaw models auth login --provider <id> --set-default का उपयोग करें।
OpenAI मॉडल संदर्भ और एजेंट रनटाइम अलग-अलग हैं:
  • openai/<model> प्रामाणिक OpenAI प्रदाता और मॉडल चुनता है। केवल उपसर्ग कभी भी Codex नहीं चुनता।
  • प्रदाता/मॉडल रनटाइम नीति सेट न होने या auto होने पर, OpenAI केवल ऐसे सटीक आधिकारिक HTTPS Platform Responses या ChatGPT Responses रूट के लिए Codex को परोक्ष रूप से चुन सकता है, जिसमें स्वयं निर्धारित अनुरोध ओवरराइड न हो।
  • स्वयं निर्धारित Completions अडैप्टर, कस्टम एंडपॉइंट और स्वयं निर्धारित अनुरोध व्यवहार वाले रूट OpenClaw पर बने रहते हैं। आधिकारिक प्लेनटेक्स्ट HTTP एंडपॉइंट अस्वीकार किए जाते हैं।
  • पुराने Codex मॉडल संदर्भ लेगेसी कॉन्फ़िगरेशन हैं, जिन्हें doctor openai/<model> में दोबारा लिखता है।
  • प्रदाता/मॉडल agentRuntime.id: "openclaw" किसी अन्यथा योग्य रूट को स्पष्ट रूप से OpenClaw पर बनाए रखता है। agentRuntime.id: "codex" के लिए Codex आवश्यक है और प्रभावी रूट Codex-संगत न होने पर यह सुरक्षित रूप से विफल होता है।
OpenAI परोक्ष एजेंट रनटाइम और Codex हार्नेस देखें। यदि प्रदाता/रनटाइम विभाजन भ्रमित करने वाला लगे, तो पहले एजेंट रनटाइम पढ़ें।Plugin का स्वतः-सक्षम होना भी इसी सीमा का पालन करता है: परोक्ष रूप से Codex-संगत प्रभावी रूट Codex Plugin को सक्षम कर सकता है, जबकि स्पष्ट प्रदाता/मॉडल agentRuntime.id: "codex" या लेगेसी codex/<model> संदर्भों के लिए यह आवश्यक है। केवल openai/* उपसर्ग ऐसा नहीं करता।नया OpenAI सेटअप रूट-विशिष्ट GPT-5.6 संदर्भ का उपयोग करता है: API-कुंजी सेटअप openai/gpt-5.6 चुनता है (बिना किसी क्वालिफ़ायर वाली प्रत्यक्ष-API आईडी Sol में रिज़ॉल्व होती है), जबकि ChatGPT/Codex OAuth नेटिव Codex कैटलॉग के लिए सटीक openai/gpt-5.6-sol चुनता है। OpenAI प्रमाणीकरण जोड़ने या रीफ़्रेश करने पर openai/gpt-5.5 सहित मौजूदा स्पष्ट प्राथमिक मॉडल बनाए रखे जाते हैं। GPT-5.6 एक्सेस रहित खातों के लिए GPT-5.5 किसी भी रनटाइम के माध्यम से स्पष्ट रिकवरी विकल्प के रूप में उपलब्ध रहता है।
CLI रनटाइम उसी विभाजन का उपयोग करते हैं: anthropic/claude-* या google/gemini-* जैसे प्रामाणिक मॉडल संदर्भ चुनें, फिर जब आप स्थानीय CLI बैकएंड चाहते हों, तो प्रदाता/मॉडल रनटाइम नीति को claude-cli या google-gemini-cli पर सेट करें।लेगेसी claude-cli/* और google-gemini-cli/* संदर्भ प्रामाणिक प्रदाता संदर्भों पर वापस माइग्रेट होते हैं और रनटाइम अलग से दर्ज किया जाता है। लेगेसी codex-cli/* संदर्भ openai/* पर माइग्रेट होते हैं और Codex ऐप-सर्वर रूट का उपयोग करते हैं; OpenClaw अब बंडल किया हुआ Codex CLI बैकएंड नहीं रखता।

Control UI में प्रदाताओं को कॉन्फ़िगर करें

models.providers.<id>.apiKey में संग्रहीत प्रदाता API कुंजियाँ जोड़ने, बदलने या हटाने के लिए Control UI में Settings → Model Providers खोलें। पृष्ठ क्रेडेंशियल प्रदर्शित किए बिना बताता है कि प्रत्येक API कुंजी OpenClaw कॉन्फ़िगरेशन से आती है या किसी एनवायरनमेंट वेरिएबल से। एनवायरनमेंट द्वारा प्रदान की गई कुंजियाँ Gateway प्रक्रिया के एनवायरनमेंट द्वारा ही प्रबंधित रहती हैं। लाइव प्रदाता जाँच चलाने और विलंबता या वर्गीकृत प्रमाणीकरण, दर-सीमा, बिलिंग, टाइमआउट या प्रतिक्रिया त्रुटि देखने के लिए Test connection का उपयोग करें। जाँच वास्तविक प्रदाता अनुरोध करती है और थोड़ी संख्या में टोकन का उपयोग कर सकती है। प्रदाता कार्ड से OAuth और टोकन प्रोफ़ाइल भी लॉग आउट की जा सकती हैं। Default models कार्ड कॉन्फ़िगर किए गए मॉडल कैटलॉग से प्राथमिक मॉडल, क्रमबद्ध फ़ॉलबैक और उपयोगिता मॉडल प्रबंधित करता है। मॉडल चुनें, फिर उन्हें मौजूदा agents.defaults.model और agents.defaults.utilityModel सेटिंग में एक साथ सहेजें। उपयोगिता मॉडल के लिए, Automatic सेटिंग को अनसेट छोड़ता है और Disabled उपयोगिता रूटिंग बंद करने के लिए एक खाली स्ट्रिंग संग्रहीत करता है।

Plugin-स्वामित्व वाला प्रदाता व्यवहार

अधिकांश प्रदाता-विशिष्ट तर्क प्रदाता Plugin (registerProvider(...)) में रहता है, जबकि OpenClaw सामान्य इन्फ़रेंस लूप बनाए रखता है। Plugin ऑनबोर्डिंग, मॉडल कैटलॉग, प्रमाणीकरण एनवायरनमेंट-वेरिएबल मैपिंग, ट्रांसपोर्ट/कॉन्फ़िगरेशन सामान्यीकरण, टूल-स्कीमा सफ़ाई, फ़ेलओवर वर्गीकरण, OAuth रीफ़्रेश, उपयोग रिपोर्टिंग, चिंतन/तर्क प्रोफ़ाइल आदि के स्वामी होते हैं। प्रदाता-SDK हुक और बंडल किए गए Plugin उदाहरणों की पूरी सूची प्रदाता Plugin में उपलब्ध है। जिस प्रदाता को पूरी तरह कस्टम अनुरोध निष्पादक चाहिए, वह एक अलग और अधिक गहन एक्सटेंशन सतह है।
प्रदाता-स्वामित्व वाला रनर व्यवहार स्पष्ट प्रदाता हुक पर रहता है, जैसे रीप्ले नीति, टूल-स्कीमा सामान्यीकरण, स्ट्रीम रैपिंग और ट्रांसपोर्ट/अनुरोध सहायक। लेगेसी ProviderPlugin.capabilities स्टैटिक बैग केवल संगतता के लिए है और अब साझा रनर तर्क द्वारा पढ़ा नहीं जाता।

API कुंजी रोटेशन

एकाधिक कुंजियाँ इनके माध्यम से कॉन्फ़िगर करें:
  • OPENCLAW_LIVE_<PROVIDER>_KEY (एकल लाइव ओवरराइड, सर्वोच्च प्राथमिकता)
  • <PROVIDER>_API_KEYS (कॉमा या सेमीकोलन सूची)
  • <PROVIDER>_API_KEY (प्राथमिक कुंजी)
  • <PROVIDER>_API_KEY_* (क्रमांकित सूची, उदाहरणार्थ <PROVIDER>_API_KEY_1)
Google प्रदाताओं के लिए, GOOGLE_API_KEY को भी फ़ॉलबैक के रूप में शामिल किया जाता है। कुंजी चयन क्रम प्राथमिकता बनाए रखता है और डुप्लिकेट मान हटाता है।
  • अनुरोधों को अगली कुंजी के साथ केवल दर-सीमा प्रतिक्रियाओं पर दोबारा आज़माया जाता है (उदाहरण के लिए 429, rate_limit, quota, resource exhausted, Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded या आवधिक उपयोग-सीमा संदेश)।
  • दर-सीमा से असंबंधित विफलताएँ तुरंत विफल होती हैं; कुंजी रोटेशन का प्रयास नहीं किया जाता।
  • जब सभी संभावित कुंजियाँ विफल हो जाती हैं, तो अंतिम प्रयास की त्रुटि लौटाई जाती है।

आधिकारिक प्रदाता Plugin

आधिकारिक प्रदाता Plugin अपने मॉडल कैटलॉग की पंक्तियाँ प्रकाशित करते हैं। इन प्रदाताओं को models.providers मॉडल प्रविष्टियों की आवश्यकता नहीं होती; प्रदाता Plugin सक्षम करें, प्रमाणीकरण सेट करें और मॉडल चुनें। models.providers का उपयोग केवल स्पष्ट कस्टम प्रदाताओं या टाइमआउट जैसी सीमित अनुरोध सेटिंग के लिए करें।

OpenAI

  • प्रदाता: openai
  • प्रमाणीकरण: OPENAI_API_KEY
  • वैकल्पिक रोटेशन: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, साथ ही OPENCLAW_LIVE_OPENAI_KEY (एकल ओवरराइड)
  • नए सेटअप का डिफ़ॉल्ट: openai/gpt-5.6; प्रत्यक्ष API पर, बिना किसी क्वालिफ़ायर वाली आईडी Sol में रिज़ॉल्व होती है।
  • उदाहरण मॉडल: openai/gpt-5.6, openai/gpt-5.6-terra, openai/gpt-5.6-luna, openai/gpt-5.5
  • यदि किसी विशिष्ट इंस्टॉल या API कुंजी का व्यवहार अलग हो, तो openclaw models list --provider openai के साथ खाते/मॉडल की उपलब्धता सत्यापित करें।
  • CLI: openclaw onboard --auth-choice openai-api-key
  • डिफ़ॉल्ट ट्रांसपोर्ट auto है; OpenClaw ट्रांसपोर्ट चयन को साझा मॉडल रनटाइम को भेजता है।
  • agents.defaults.models["openai/<model>"].params.transport के माध्यम से प्रति मॉडल ओवरराइड करें ("sse", "websocket" या "auto")
  • OpenAI प्राथमिकता प्रसंस्करण को agents.defaults.models["openai/<model>"].params.serviceTier के माध्यम से सक्षम किया जा सकता है
  • /fast और params.fastMode, openai/* के प्रत्यक्ष Responses अनुरोधों को api.openai.com पर service_tier=priority में मैप करते हैं
  • जब आप साझा /fast टॉगल के बजाय स्पष्ट टियर चाहते हों, तो params.serviceTier का उपयोग करें
  • छिपे हुए OpenClaw एट्रिब्यूशन हेडर (originator, version, User-Agent) केवल api.openai.com के नेटिव OpenAI ट्रैफ़िक पर लागू होते हैं, सामान्य OpenAI-संगत प्रॉक्सी पर नहीं
  • नेटिव OpenAI रूट Responses store, प्रॉम्प्ट-कैश संकेत और OpenAI तर्क-संगतता पेलोड आकार देना भी बनाए रखते हैं; प्रॉक्सी रूट ऐसा नहीं करते
  • openai/gpt-5.3-codex-spark केवल ChatGPT/Codex OAuth के माध्यम से उपलब्ध है; प्रत्यक्ष OpenAI API-कुंजी और Azure API-कुंजी रूट इसे अस्वीकार करते हैं
यदि API संगठन GPT-5.6 उपलब्ध नहीं कराता, तो openai/gpt-5.5 को स्पष्ट रूप से सेट करें। सामान्य ऑनबोर्डिंग और पुनः प्रमाणीकरण किसी मौजूदा स्पष्ट प्राथमिक मॉडल को बनाए रखते हैं; models auth login --set-default और models set जानबूझकर प्रतिस्थापन के मार्ग हैं।

Anthropic

  • प्रदाता: anthropic
  • प्रमाणीकरण: ANTHROPIC_API_KEY
  • वैकल्पिक रोटेशन: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, साथ ही OPENCLAW_LIVE_ANTHROPIC_KEY (एकल ओवरराइड)
  • उदाहरण मॉडल: anthropic/claude-opus-5
  • CLI: openclaw onboard --auth-choice apiKey
  • प्रत्यक्ष सार्वजनिक Anthropic अनुरोध साझा /fast टॉगल और params.fastMode का समर्थन करते हैं, जिसमें api.anthropic.com को भेजा गया API-कुंजी और OAuth-प्रमाणीकृत ट्रैफ़िक शामिल है; OpenClaw इसे Anthropic service_tier (auto बनाम standard_only) में मैप करता है
  • पसंदीदा Claude CLI कॉन्फ़िगरेशन मॉडल संदर्भ को प्रामाणिक रखता है और CLI बैकएंड को अलग से चुनता है: मॉडल-स्कोप वाले agentRuntime.id: "claude-cli" के साथ anthropic/claude-opus-5। लेगेसी claude-cli/claude-opus-4-7 संदर्भ संगतता के लिए अब भी काम करते हैं।
Claude CLI का पुनः उपयोग (claude -p) OpenClaw का स्वीकृत एकीकरण मार्ग है। Anthropic सेटअप-टोकन प्रमाणीकरण समर्थित बना हुआ है, लेकिन उपलब्ध होने पर OpenClaw Claude CLI के पुनः उपयोग को प्राथमिकता देता है।

OpenAI ChatGPT/Codex OAuth

  • प्रदाता: openai
  • प्रमाणीकरण: OAuth (ChatGPT)
  • नया नेटिव Codex app-server हार्नेस संदर्भ: openai/gpt-5.6-sol
  • नेटिव Codex app-server हार्नेस दस्तावेज़: Codex हार्नेस
  • लेगेसी मॉडल संदर्भ: codex/gpt-*, openai-codex/gpt-*
  • Plugin सीमा: openai/* OpenAI Plugin को लोड करता है; स्पष्ट रनटाइम नीति या प्रदाता के स्वामित्व वाला प्रभावी रूट तय करता है कि नेटिव Codex app-server Plugin चुना जाए या नहीं।
  • CLI: openclaw onboard --auth-choice openai या openclaw models auth login --provider openai
  • OpenClaw का एम्बेडेड ChatGPT Responses ट्रांसपोर्ट डिफ़ॉल्ट रूप से auto (पहले WebSocket, फ़ॉलबैक के रूप में SSE) का उपयोग करता है।
  • agents.defaults.models["openai/<model>"].params.transport, params.serviceTier, और params.fastMode लेखित एम्बेडेड-अनुरोध सेटिंग्स हैं। ये अंतर्निहित रनटाइम चयन को OpenClaw पर बनाए रखती हैं; नेटिव Codex अपने app-server ट्रांसपोर्ट और सेवा स्तर का स्वामी होता है।
  • छिपे हुए OpenClaw एट्रिब्यूशन हेडर (originator, version, User-Agent) केवल chatgpt.com/backend-api पर जाने वाले नेटिव Codex ट्रैफ़िक में जोड़े जाते हैं, सामान्य OpenAI-संगत प्रॉक्सी में नहीं
  • साझा /fast टॉगल रनटाइम नियंत्रण के रूप में उपलब्ध रहता है; यह लेखित मॉडल पैरामीटर से अलग है।
  • नेटिव Codex कैटलॉग खाते की पहुँच के अनुसार सटीक openai/gpt-5.6-sol, openai/gpt-5.6-terra, और openai/gpt-5.6-luna संदर्भ दिखा सकता है। यह सीधे API के केवल gpt-5.6 वाले उपनाम को क्लाइंट की ओर लागू नहीं करता।
  • openai/gpt-5.5 Codex कैटलॉग के नेटिव contextWindow = 400000 और डिफ़ॉल्ट रनटाइम contextTokens = 272000 का उपयोग करता है; रनटाइम सीमा को models.providers.openai.models[].contextTokens से ओवरराइड करें
  • openai प्रमाणीकरण से साइन इन करें और नई सदस्यता-समर्थित स्थापना के लिए openai/gpt-5.6-sol का उपयोग करें। यदि वह Codex कार्यस्थान GPT-5.6 उपलब्ध नहीं कराता, तो openai/gpt-5.5 को स्पष्ट रूप से चुनें।
  • अन्यथा योग्य रूट को अंतर्निर्मित रनटाइम पर बनाए रखने के लिए प्रदाता/मॉडल agentRuntime.id: "openclaw" का उपयोग करें। रनटाइम सेट न होने या auto होने पर, केवल बिना किसी लेखित अनुरोध ओवरराइड वाला सटीक आधिकारिक HTTPS Responses/ChatGPT-संगत रूट ही Codex को अंतर्निहित रूप से चुन सकता है।
  • लेगेसी Codex GPT संदर्भ लेगेसी स्थिति हैं, कोई सक्रिय प्रदाता रूट नहीं। नए एजेंट कॉन्फ़िगरेशन के लिए मानक openai/* संदर्भों का उपयोग करें, और मॉडल-स्कोप वाले agentRuntime.id: "codex" के साथ उनके नेटिव Codex अर्थ को सुरक्षित रखते हुए codex/* और openai-codex/* संदर्भों को माइग्रेट करने के लिए openclaw doctor --fix चलाएँ। मौजूदा स्पष्ट मानक openai/gpt-5.5 चयनों को अपग्रेड नहीं किया जाता।

सदस्यता-शैली के अन्य होस्टेड विकल्प

MiniMax

MiniMax Coding Plan OAuth या API कुंजी पहुँच।

Qwen Cloud

Qwen Cloud प्रदाता सतह के साथ Alibaba DashScope और Coding Plan एंडपॉइंट मैपिंग।

Z.AI (GLM)

Z.AI Coding Plan या सामान्य API एंडपॉइंट।

OpenCode

  • प्रमाणीकरण: OPENCODE_API_KEY (या OPENCODE_ZEN_API_KEY)
  • Zen रनटाइम प्रदाता: opencode
  • Go रनटाइम प्रदाता: opencode-go
  • उदाहरण मॉडल: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
  • CLI: openclaw onboard --auth-choice opencode-zen या openclaw onboard --auth-choice opencode-go

Google Gemini (API कुंजी)

  • प्रदाता: google
  • प्रमाणीकरण: GEMINI_API_KEY
  • वैकल्पिक रोटेशन: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, GOOGLE_API_KEY फ़ॉलबैक, और OPENCLAW_LIVE_GEMINI_KEY (एकल ओवरराइड)
  • उदाहरण मॉडल: google/gemini-3.1-pro-preview, google/gemini-3.5-flash
  • संगतता: google/gemini-3.1-flash-preview का उपयोग करने वाला लेगेसी OpenClaw कॉन्फ़िगरेशन google/gemini-3-flash-preview में सामान्यीकृत किया जाता है
  • उपनाम: google/gemini-3.1-pro स्वीकार किया जाता है और Google की सक्रिय Gemini API आईडी, google/gemini-3.1-pro-preview, में सामान्यीकृत किया जाता है
  • CLI: openclaw onboard --auth-choice gemini-api-key
  • चिंतन: /think adaptive Google के डायनेमिक चिंतन का उपयोग करता है। Gemini 3/3.1 निश्चित thinkingLevel को छोड़ देते हैं; Gemini 2.5 thinkingBudget: -1 भेजता है।
  • सीधे Gemini रन प्रदाता-नेटिव cachedContents/... हैंडल को अग्रेषित करने के लिए agents.defaults.models["google/<model>"].params.cachedContent (या लेगेसी cached_content) भी स्वीकार करते हैं; Gemini कैश हिट OpenClaw cacheRead के रूप में दिखाई देते हैं

Google Vertex और Gemini CLI

  • प्रदाता: google-vertex, google-gemini-cli
  • प्रमाणीकरण: Vertex gcloud ADC का उपयोग करता है; Gemini CLI अपने OAuth प्रवाह का उपयोग करता है
OpenClaw में Gemini CLI OAuth एक अनौपचारिक एकीकरण है। कुछ उपयोगकर्ताओं ने तृतीय-पक्ष क्लाइंट का उपयोग करने के बाद Google खाते पर प्रतिबंध लगने की सूचना दी है। आगे बढ़ने का विकल्प चुनने पर Google की शर्तों की समीक्षा करें और किसी गैर-महत्वपूर्ण खाते का उपयोग करें।
Gemini CLI OAuth को बंडल किए गए google Plugin के भाग के रूप में भेजा जाता है।
1

Gemini CLI इंस्टॉल करें

2

Plugin सक्षम करें

3

लॉग इन करें

डिफ़ॉल्ट मॉडल: google-gemini-cli/gemini-3-flash-preview। आप openclaw.json में क्लाइंट आईडी या सीक्रेट पेस्ट नहीं करते। CLI लॉगिन प्रवाह Gateway होस्ट पर प्रमाणीकरण प्रोफ़ाइल में टोकन संग्रहीत करता है।
4

प्रोजेक्ट सेट करें (यदि आवश्यक हो)

यदि लॉगिन के बाद अनुरोध विफल हों, तो Gateway होस्ट पर GOOGLE_CLOUD_PROJECT या GOOGLE_CLOUD_PROJECT_ID सेट करें।
Gemini CLI डिफ़ॉल्ट रूप से stream-json का उपयोग करता है। OpenClaw सहायक स्ट्रीम संदेशों को पढ़ता है और stats.cached को cacheRead में सामान्यीकृत करता है; लेगेसी --output-format json ओवरराइड अभी भी response से उत्तर का टेक्स्ट पढ़ते हैं।

Z.AI (GLM)

  • प्रदाता: zai
  • प्रमाणीकरण: ZAI_API_KEY
  • उदाहरण मॉडल: zai/glm-5.2
  • CLI: openclaw onboard --auth-choice zai-api-key
    • मॉडल संदर्भ मानक zai/* प्रदाता आईडी का उपयोग करते हैं।
    • zai-api-key मेल खाने वाले Z.AI एंडपॉइंट का स्वतः पता लगाता है; zai-coding-global, zai-coding-cn, zai-global, और zai-cn किसी विशिष्ट सतह को बाध्य करते हैं

Vercel AI Gateway

  • प्रदाता: vercel-ai-gateway
  • प्रमाणीकरण: AI_GATEWAY_API_KEY
  • उदाहरण मॉडल: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
  • CLI: openclaw onboard --auth-choice ai-gateway-api-key

अन्य बंडल किए गए प्रदाता Plugin

जानने योग्य विशिष्टताएँ

अपने ऐप-एट्रिब्यूशन हेडर और Anthropic cache_control मार्कर केवल सत्यापित openrouter.ai रूट पर लागू करता है। DeepSeek, Moonshot और ZAI रेफ़रेंस OpenRouter-प्रबंधित प्रॉम्प्ट कैशिंग के लिए कैश-TTL योग्य हैं, लेकिन उन्हें Anthropic कैश मार्कर नहीं मिलते। प्रॉक्सी-शैली के OpenAI-संगत पथ के रूप में, यह केवल नेटिव-OpenAI शेपिंग (serviceTier, Responses store, प्रॉम्प्ट-कैश संकेत, OpenAI रीजनिंग-संगतता) को छोड़ देता है। Gemini-समर्थित रेफ़रेंस केवल प्रॉक्सी-Gemini थॉट-सिग्नेचर सैनिटाइज़ेशन बनाए रखते हैं।
Gemini-समर्थित रेफ़रेंस उसी प्रॉक्सी-Gemini सैनिटाइज़ेशन पथ का पालन करते हैं; kilocode/kilo-auto/balanced और अन्य प्रॉक्सी-रीजनिंग-असमर्थित रेफ़रेंस प्रॉक्सी रीजनिंग इंजेक्शन को छोड़ देते हैं।
API-कुंजी ऑनबोर्डिंग स्पष्ट M3 और M2.7 चैट मॉडल परिभाषाएँ लिखती है; छवि-बोध Plugin-स्वामित्व वाले MiniMax-VL-01 मीडिया प्रदाता पर बना रहता है।
मॉडल आईडी nvidia/<vendor>/<model> नेमस्पेस का उपयोग करते हैं (उदाहरण के लिए nvidia/nvidia/nemotron-...); पिकर शाब्दिक <provider>/<model-id> संयोजन बनाए रखते हैं, जबकि API को भेजी गई कैनोनिकल कुंजी एकल-प्रीफ़िक्स वाली रहती है।
xAI Responses पथ का उपयोग करता है। अनुशंसित पथ SuperGrok/X Premium OAuth है; API कुंजियाँ अब भी XAI_API_KEY या Plugin कॉन्फ़िगरेशन के माध्यम से काम करती हैं, और Grok web_search API-कुंजी फ़ॉलबैक से पहले उसी प्रमाणीकरण प्रोफ़ाइल का पुनः उपयोग करता है। जहाँ उपलब्ध हो, Grok 4.5 को चैट, कोडिंग और एजेंटिक कार्य के लिए चुना जा सकता है; grok-4.3 क्षेत्रीय-सुरक्षित बंडल्ड डिफ़ॉल्ट बना रहता है। पुराने /fast और params.fastMode: true कॉन्फ़िगरेशन अब भी xAI के Grok 4.3 संगतता रीडायरेक्ट के माध्यम से रिज़ॉल्व होते हैं, लेकिन नए कॉन्फ़िगरेशन को सीधे कोई मौजूदा मॉडल चुनना चाहिए। tool_stream डिफ़ॉल्ट रूप से चालू है; agents.defaults.models["xai/<model>"].params.tool_stream=false के माध्यम से अक्षम करें।

models.providers (कस्टम/बेस URL) के माध्यम से प्रदाता

कस्टम प्रदाता या OpenAI/Anthropic-संगत प्रॉक्सी जोड़ने के लिए models.providers (या models.json) का उपयोग करें। नीचे दिए गए कई बंडल्ड प्रदाता Plugin पहले से एक डिफ़ॉल्ट कैटलॉग प्रकाशित करते हैं। स्पष्ट models.providers.<id> प्रविष्टियों का उपयोग केवल तब करें, जब आप डिफ़ॉल्ट बेस URL, हेडर या मॉडल सूची को ओवरराइड करना चाहते हों। बंडल्ड और कैटलॉग-ज्ञात रूट अपनी compat क्षमताएँ स्वामी प्रदाता Plugin से लेते हैं। कॉन्फ़िगरेशन का compat ब्लॉक किसी कस्टम प्रदाता/मॉडल या ऐसे भिन्न api/baseUrl रूट के लिए है, जिसके एंडपॉइंट अनुबंध को आपने सत्यापित किया है; कस्टम-प्रदाता क्षमता मार्गदर्शिका देखें। Doctor उन लेगेसी मानों को हटा देता है जो केवल कैटलॉग को दोहराते हैं और अलग मानों को ऑपरेटर की समीक्षा के लिए दृश्यमान रखता है। Gateway मॉडल क्षमता जाँच स्पष्ट models.providers.<id>.models[] मेटाडेटा भी पढ़ती है। यदि कोई कस्टम या प्रॉक्सी मॉडल छवियाँ स्वीकार करता है, तो उस मॉडल पर input: ["text", "image"] सेट करें, ताकि WebChat और Node-मूल अटैचमेंट पथ छवियों को केवल-पाठ मीडिया रेफ़रेंस के बजाय नेटिव मॉडल इनपुट के रूप में पास करें। agents.defaults.models["provider/model"] एजेंटों के लिए उपनाम और प्रति-मॉडल मेटाडेटा नियंत्रित करता है। यह न तो ओवरराइड को प्रतिबंधित करता है, न ही स्वयं कोई नया रनटाइम मॉडल पंजीकृत करता है। कस्टम प्रदाता मॉडल के लिए, कम-से-कम मेल खाता id सहित models.providers.<provider>.models[] भी जोड़ें; जब आप ओवरराइड प्रतिबंध चाहते हों, तो agents.defaults.modelPolicy.allow का अलग से उपयोग करें।

Moonshot AI (Kimi)

ऑनबोर्डिंग से पहले @openclaw/moonshot-provider इंस्टॉल करें। स्पष्ट models.providers.moonshot प्रविष्टि केवल तब जोड़ें, जब आपको बेस URL या मॉडल मेटाडेटा ओवरराइड करना हो:
  • प्रदाता: moonshot
  • प्रमाणीकरण: MOONSHOT_API_KEY
  • उदाहरण मॉडल: moonshot/kimi-k3
  • CLI: openclaw onboard --auth-choice moonshot-api-key या openclaw onboard --auth-choice moonshot-api-key-cn
Kimi मॉडल आईडी:
  • moonshot/kimi-k2.6
  • moonshot/kimi-k3
  • moonshot/kimi-k2.7-code
  • moonshot/kimi-k2.7-code-highspeed
  • moonshot/kimi-k2.5
पूरी सेटअप मार्गदर्शिका के लिए Moonshot AI (Kimi + Kimi Coding) देखें।

Kimi Coding

Kimi Coding, Moonshot AI के Anthropic-संगत एंडपॉइंट का उपयोग करता है:
  • प्रदाता: kimi
  • प्रमाणीकरण: KIMI_API_KEY
  • Kimi K3: kimi/k3 (256K) या kimi/k3[1m] (1M प्लान)
  • Kimi Code: kimi/kimi-for-coding
  • Kimi Code HighSpeed: kimi/kimi-for-coding-highspeed
लेगेसी kimi/kimi-code और kimi/k2p5 संगतता मॉडल आईडी के रूप में अब भी स्वीकार किए जाते हैं और Kimi के स्थिर API मॉडल आईडी में सामान्यीकृत होते हैं।

Volcano Engine (Doubao)

Volcano Engine (火山引擎) चीन में Doubao और अन्य मॉडलों तक पहुँच प्रदान करता है।
  • प्रदाता: volcengine (कोडिंग: volcengine-plan)
  • प्रमाणीकरण: VOLCANO_ENGINE_API_KEY
  • उदाहरण मॉडल: volcengine-plan/ark-code-latest
  • CLI: openclaw onboard --auth-choice volcengine-api-key
ऑनबोर्डिंग डिफ़ॉल्ट रूप से कोडिंग सतह का उपयोग करती है, लेकिन सामान्य volcengine/* कैटलॉग उसी समय पंजीकृत होता है। ऑनबोर्डिंग/कॉन्फ़िगर मॉडल पिकर में, Volcengine प्रमाणीकरण विकल्प volcengine/* और volcengine-plan/* दोनों पंक्तियों को प्राथमिकता देता है। यदि वे मॉडल अभी लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप्ड पिकर दिखाने के बजाय बिना फ़िल्टर वाले कैटलॉग पर फ़ॉलबैक करता है।
  • volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
  • volcengine/doubao-seed-code-preview-251028
  • volcengine/kimi-k2-5-260127 (Kimi K2.5)
  • volcengine/glm-4-7-251222 (GLM 4.7)
  • volcengine/deepseek-v3-2-251201 (DeepSeek V3.2)

BytePlus (अंतरराष्ट्रीय)

BytePlus ARK अंतरराष्ट्रीय उपयोगकर्ताओं को Volcano Engine वाले समान मॉडलों तक पहुँच प्रदान करता है।
  • प्रदाता: byteplus (कोडिंग: byteplus-plan)
  • प्रमाणीकरण: BYTEPLUS_API_KEY
  • उदाहरण मॉडल: byteplus-plan/ark-code-latest
  • CLI: openclaw onboard --auth-choice byteplus-api-key
ऑनबोर्डिंग डिफ़ॉल्ट रूप से कोडिंग सतह का उपयोग करती है, लेकिन सामान्य byteplus/* कैटलॉग भी उसी समय पंजीकृत होता है। ऑनबोर्डिंग/कॉन्फ़िगरेशन मॉडल चयनकर्ताओं में, BytePlus प्रमाणीकरण विकल्प byteplus/* और byteplus-plan/* दोनों पंक्तियों को प्राथमिकता देता है। यदि वे मॉडल अभी तक लोड नहीं हुए हैं, तो OpenClaw खाली प्रदाता-स्कोप वाला चयनकर्ता दिखाने के बजाय फ़िल्टर-रहित कैटलॉग पर वापस जाता है।
  • byteplus/seed-1-8-251228 (Seed 1.8)
  • byteplus/kimi-k2-5-260127 (Kimi K2.5)
  • byteplus/glm-4-7-251222 (GLM 4.7)

Synthetic

Synthetic, synthetic प्रदाता के माध्यम से Anthropic-संगत मॉडल प्रदान करता है:
  • प्रदाता: synthetic
  • प्रमाणीकरण: SYNTHETIC_API_KEY
  • उदाहरण मॉडल: synthetic/hf:MiniMaxAI/MiniMax-M3
  • CLI: openclaw onboard --auth-choice synthetic-api-key

MiniMax

MiniMax को models.providers के माध्यम से कॉन्फ़िगर किया जाता है, क्योंकि यह कस्टम एंडपॉइंट का उपयोग करता है:
  • MiniMax OAuth (वैश्विक): --auth-choice minimax-global-oauth
  • MiniMax OAuth (चीन): --auth-choice minimax-cn-oauth
  • MiniMax API कुंजी (वैश्विक): --auth-choice minimax-global-api
  • MiniMax API कुंजी (चीन): --auth-choice minimax-cn-api
  • प्रमाणीकरण: minimax के लिए MINIMAX_API_KEY; minimax-portal के लिए MINIMAX_OAUTH_TOKEN या MINIMAX_API_KEY
सेटअप विवरण, मॉडल विकल्पों और कॉन्फ़िगरेशन स्निपेट के लिए /providers/minimax देखें।
MiniMax के Anthropic-संगत स्ट्रीमिंग पथ पर, OpenClaw M2.x परिवार के लिए डिफ़ॉल्ट रूप से थिंकिंग अक्षम करता है, जब तक कि आप इसे स्पष्ट रूप से सेट न करें; MiniMax-M3 (और M3.x) डिफ़ॉल्ट रूप से प्रदाता के छोड़े गए/अनुकूली थिंकिंग पथ पर बना रहता है। /fast on, MiniMax-M2.7 को MiniMax-M2.7-highspeed में पुनर्लिखित करता है।
Plugin-स्वामित्व वाला क्षमता विभाजन:
  • टेक्स्ट/चैट डिफ़ॉल्ट minimax/MiniMax-M3 पर बने रहते हैं
  • छवि निर्माण minimax/image-01 या minimax-portal/image-01 है
  • दोनों MiniMax प्रमाणीकरण पथों पर छवि समझ Plugin-स्वामित्व वाला MiniMax-VL-01 है
  • वेब खोज प्रदाता आईडी minimax पर बनी रहती है

LM Studio

LM Studio एक बंडल प्रदाता Plugin के रूप में उपलब्ध होता है, जो मूल API का उपयोग करता है:
  • प्रदाता: lmstudio
  • प्रमाणीकरण: LM_API_TOKEN
  • डिफ़ॉल्ट अनुमान बेस URL: http://localhost:1234/v1
फिर एक मॉडल सेट करें (http://localhost:1234/api/v1/models द्वारा लौटाई गई आईडी में से किसी एक से बदलें):
OpenClaw खोज और स्वचालित लोडिंग के लिए LM Studio के मूल /api/v1/models और /api/v1/models/load का उपयोग करता है तथा डिफ़ॉल्ट रूप से अनुमान के लिए /v1/chat/completions का उपयोग करता है। यदि आप चाहते हैं कि LM Studio JIT लोडिंग, TTL और स्वचालित निष्कासन के माध्यम से मॉडल जीवनचक्र का स्वामित्व संभाले, तो models.providers.lmstudio.params.preload: false सेट करें। सेटअप और समस्या निवारण के लिए /providers/lmstudio देखें।

Ollama

Ollama एक बंडल प्रदाता Plugin के रूप में उपलब्ध होता है और Ollama के मूल API का उपयोग करता है:
  • प्रदाता: ollama
  • प्रमाणीकरण: आवश्यक नहीं (स्थानीय सर्वर)
  • उदाहरण मॉडल: ollama/llama3.3
  • इंस्टॉलेशन: https://ollama.com/download
जब आप OLLAMA_API_KEY से ऑप्ट इन करते हैं, तो Ollama का स्थानीय रूप से http://127.0.0.1:11434 पर पता लगाया जाता है, और बंडल प्रदाता Plugin, Ollama को सीधे openclaw onboard तथा मॉडल चयनकर्ता में जोड़ता है। ऑनबोर्डिंग, क्लाउड/स्थानीय मोड और कस्टम कॉन्फ़िगरेशन के लिए /providers/ollama देखें।

vLLM

vLLM स्थानीय/स्व-होस्टेड OpenAI-संगत सर्वरों के लिए एक बंडल प्रदाता Plugin के रूप में उपलब्ध होता है:
  • प्रदाता: vllm
  • प्रमाणीकरण: वैकल्पिक (आपके सर्वर पर निर्भर)
  • डिफ़ॉल्ट बेस URL: http://127.0.0.1:8000/v1
स्थानीय स्वचालित खोज के लिए ऑप्ट इन करने हेतु (यदि आपका सर्वर प्रमाणीकरण लागू नहीं करता, तो कोई भी मान काम करेगा):
फिर एक मॉडल सेट करें (/v1/models द्वारा लौटाई गई आईडी में से किसी एक से बदलें):
विवरण के लिए /providers/vllm देखें।

SGLang

SGLang तेज़ स्व-होस्टेड OpenAI-संगत सर्वरों के लिए एक बंडल प्रदाता Plugin के रूप में उपलब्ध होता है:
  • प्रदाता: sglang
  • प्रमाणीकरण: वैकल्पिक (आपके सर्वर पर निर्भर)
  • डिफ़ॉल्ट बेस URL: http://127.0.0.1:30000/v1
स्थानीय स्वचालित खोज के लिए ऑप्ट इन करने हेतु (यदि आपका सर्वर प्रमाणीकरण लागू नहीं करता, तो कोई भी मान काम करेगा):
फिर एक मॉडल सेट करें (/v1/models द्वारा लौटाई गई आईडी में से किसी एक से बदलें):
विवरण के लिए /providers/sglang देखें।

स्थानीय प्रॉक्सी (LM Studio, vLLM, LiteLLM आदि)

उदाहरण (OpenAI-संगत):
कस्टम प्रदाताओं के लिए, reasoning, input, cost, contextWindow और maxTokens वैकल्पिक हैं। इन्हें छोड़ने पर, OpenClaw के डिफ़ॉल्ट ये होते हैं:
  • reasoning: false
  • input: ["text"]
  • cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
  • contextWindow: 200000
  • maxTokens: 8192
अनुशंसित: अपने प्रॉक्सी/मॉडल की सीमाओं से मेल खाने वाले स्पष्ट मान सेट करें।
  • गैर-मूल एंडपॉइंट पर api: "openai-completions" के लिए (कोई भी गैर-रिक्त baseUrl, जिसका होस्ट api.openai.com नहीं है), OpenClaw असमर्थित developer भूमिकाओं के कारण होने वाली प्रदाता 400 त्रुटियों से बचने के लिए compat.supportsDeveloperRole: false को बाध्य करता है।
  • प्रॉक्सी-शैली के OpenAI-संगत रूट केवल मूल OpenAI के अनुरोध आकार-निर्धारण को भी छोड़ देते हैं: कोई service_tier नहीं, कोई Responses store नहीं, कोई Completions store नहीं, कोई प्रॉम्प्ट-कैश संकेत नहीं, कोई OpenAI रीजनिंग-संगतता पेलोड आकार-निर्धारण नहीं और कोई छिपा हुआ OpenClaw श्रेय हेडर नहीं।
  • विक्रेता-विशिष्ट फ़ील्ड की आवश्यकता वाले OpenAI-संगत Completions प्रॉक्सी के लिए, आउटबाउंड अनुरोध बॉडी में अतिरिक्त JSON मर्ज करने हेतु agents.defaults.models["provider/model"].params.extra_body (या extraBody) सेट करें।
  • vLLM चैट-टेम्पलेट नियंत्रणों के लिए, agents.defaults.models["provider/model"].params.chat_template_kwargs सेट करें। जब सत्र का थिंकिंग स्तर बंद होता है, तब बंडल vLLM Plugin, vllm/nemotron-3-* के लिए स्वचालित रूप से enable_thinking: false और force_nonempty_content: true भेजता है।
  • धीमे स्थानीय मॉडल या दूरस्थ LAN/टेलनेट होस्ट के लिए, models.providers.<id>.timeoutSeconds सेट करें। यह पूरे एजेंट रनटाइम टाइमआउट को बढ़ाए बिना, कनेक्ट, हेडर, बॉडी स्ट्रीमिंग और कुल संरक्षित-फ़ेच निरस्तीकरण सहित प्रदाता मॉडल HTTP अनुरोध प्रबंधन को विस्तारित करता है। यदि agents.defaults.timeoutSeconds या किसी रन-विशिष्ट टाइमआउट की सीमा कम है, तो उस सीमा को भी बढ़ाएँ; प्रदाता टाइमआउट पूरे रन को विस्तारित नहीं कर सकते।
  • मॉडल प्रदाता HTTP कॉल, Surge, Clash और sing-box के नकली-IP DNS उत्तरों को 198.18.0.0/15 और fc00::/7 में केवल कॉन्फ़िगर किए गए प्रदाता baseUrl होस्टनाम के लिए अनुमति देते हैं। कस्टम/स्थानीय प्रदाता एंडपॉइंट संरक्षित मॉडल अनुरोधों के लिए ठीक उसी कॉन्फ़िगर किए गए scheme://host:port मूल पर भी भरोसा करते हैं, जिसमें लूपबैक, LAN और टेलनेट होस्ट शामिल हैं। यह कोई नया कॉन्फ़िगरेशन विकल्प नहीं है; आपके द्वारा कॉन्फ़िगर किया गया baseUrl केवल उस मूल के लिए अनुरोध नीति को विस्तारित करता है। नकली-IP होस्टनाम अनुमति और सटीक-मूल विश्वास स्वतंत्र तंत्र हैं। अन्य निजी, लूपबैक, लिंक-स्थानीय, मेटाडेटा गंतव्यों और अलग पोर्ट के लिए अब भी स्पष्ट models.providers.<id>.request.allowPrivateNetwork: true ऑप्ट-इन आवश्यक है। सटीक-मूल विश्वास से ऑप्ट आउट करने के लिए models.providers.<id>.request.allowPrivateNetwork: false सेट करें।
  • यदि baseUrl रिक्त/छोड़ा हुआ है, तो OpenClaw डिफ़ॉल्ट OpenAI व्यवहार बनाए रखता है (जो api.openai.com में परिणत होता है)।
  • सुरक्षा के लिए, गैर-मूल openai-completions एंडपॉइंट पर स्पष्ट compat.supportsDeveloperRole: true को अब भी ओवरराइड किया जाता है।
  • गैर-प्रत्यक्ष एंडपॉइंट पर api: "anthropic-messages" के लिए (कैनोनिकल anthropic के अलावा कोई भी प्रदाता, या ऐसा कस्टम models.providers.anthropic.baseUrl जिसका होस्ट कोई सार्वजनिक api.anthropic.com एंडपॉइंट नहीं है), OpenClaw claude-code-20250219, interleaved-thinking-2025-05-14 और OAuth मार्कर जैसे अंतर्निहित Anthropic बीटा हेडर दबा देता है, ताकि कस्टम Anthropic-संगत प्रॉक्सी असमर्थित बीटा फ़्लैग अस्वीकार न करें। यदि आपके प्रॉक्सी को विशिष्ट बीटा सुविधाओं की आवश्यकता है, तो models.providers.<id>.headers["anthropic-beta"] स्पष्ट रूप से सेट करें।

CLI उदाहरण

पूर्ण कॉन्फ़िगरेशन उदाहरणों के लिए यह भी देखें: कॉन्फ़िगरेशन

संबंधित