Providers
OpenAI
OpenClaw प्रत्यक्ष API-कुंजी प्रमाणीकरण और ChatGPT/Codex सदस्यता प्रमाणीकरण, दोनों के लिए एक ही प्रदाता आईडी, openai, का उपयोग करता है।
openai/* प्रामाणिक मॉडल रूट है।
रनटाइम नीति के अनिर्धारित या auto होने पर, एम्बेडेड एजेंट टर्न के लिए OpenAI के रूट
तथ्य तय करते हैं कि OpenClaw बंडल किए गए Codex ऐप-सर्वर रनटाइम को
अंतर्निहित रूप से चुन सकता है या नहीं। केवल openai/* उपसर्ग किसी रनटाइम का चयन नहीं करता।
- एजेंट मॉडल - स्पष्ट
agentRuntimeकॉन्फ़िगरेशन या OpenAI की अंतर्निहित रूट नीति द्वारा चुने गए रनटाइम के माध्यम सेopenai/*। ChatGPT/Codex सदस्यता उपयोग के लिए Codex प्रमाणीकरण से साइन इन करें, या कुंजी-आधारित बिलिंग चाहिए तो API-कुंजी प्रमाणीकरण प्रोफ़ाइल कॉन्फ़िगर करें। - गैर-एजेंट OpenAI API -
OPENAI_API_KEYया किसीopenaiAPI-कुंजी प्रमाणीकरण प्रोफ़ाइल के माध्यम से, प्रति उपयोग बिल किए जाने वाला प्रत्यक्ष OpenAI Platform एक्सेस। - लेगेसी कॉन्फ़िगरेशन -
codex/*औरopenai-codex/*संदर्भों कोopenclaw doctor --fixद्वाराopenai/*और मॉडल-स्कोप वालेagentRuntime.id: "codex"में सुधारा जाता है।
OpenAI बाहरी टूल और OpenClaw जैसे वर्कफ़्लो में सदस्यता OAuth के उपयोग का स्पष्ट रूप से समर्थन करता है।
उपयोग और लागत ट्रैकिंग
OpenClaw सदस्यता कोटा और Platform API बिलिंग को अलग रखता है:
- ChatGPT/Codex OAuth सदस्यता योजना, कोटा विंडो और क्रेडिट शेष दिखाता है।
OPENAI_ADMIN_KEYControl UI के उपयोग में प्रदाता द्वारा रिपोर्ट की गई संगठन लागत और पूर्णताओं के 30 दिनों के उपयोग को दिखाता है, जिसमें दैनिक खर्च, अनुरोध/टोकन योग, शीर्ष मॉडल और लागत श्रेणियाँ शामिल हैं।OPENAI_PROJECT_IDवैकल्पिक रूप से Admin API इतिहास को किसी एक प्रोजेक्ट तक सीमित करता है।- OpenClaw कभी भी
OPENAI_API_KEYया किसीopenaiअनुमान प्रोफ़ाइल को संगठन API पर नहीं भेजता; वे क्रेडेंशियल कस्टम, Azure या एजेंट-स्थानीय एंडपॉइंट से संबंधित हो सकते हैं।
स्पष्ट Admin कुंजी को OAuth पर प्राथमिकता मिलती है। प्रदाता द्वारा रिपोर्ट किए गए इतिहास को OpenClaw की सत्र-व्युत्पन्न अनुमानित लागत के साथ मर्ज नहीं किया जाता; इसमें अन्य क्लाइंट की API गतिविधि और प्रदाता-पक्ष के बिलिंग समायोजन शामिल हो सकते हैं।
OpenAI का API उपयोग डैशबोर्ड दस्तावेज़ उपयोग डेटा के लिए संगठन-स्वामी और स्पष्ट Usage Dashboard अनुमति आवश्यकताओं का वर्णन करता है।
प्रदाता, मॉडल, रनटाइम और चैनल अलग-अलग परतें हैं। यदि ये लेबल आपस में मिल रहे हैं, तो कॉन्फ़िगरेशन बदलने से पहले एजेंट रनटाइम पढ़ें।
त्वरित चयन
| लक्ष्य | उपयोग करें | टिप्पणियाँ |
|---|---|---|
| ChatGPT/Codex सदस्यता, नेटिव Codex रनटाइम | openai/gpt-5.6-sol |
नया सदस्यता सेटअप; Codex प्रमाणीकरण से साइन इन करें। |
| एजेंट टर्न के लिए प्रत्यक्ष API-कुंजी बिलिंग | openai/gpt-5.6 और एक क्रमबद्ध API-कुंजी प्रमाणीकरण प्रोफ़ाइल |
नया API-कुंजी सेटअप; केवल प्रत्यक्ष-API आईडी Sol में रिज़ॉल्व होती है। |
| सटीक GPT-5.6 टियर चुनें | openai/gpt-5.6-sol, -terra, या -luna |
इस खाते के लिए उपलब्ध टियर जानने हेतु models list देखें। |
| GPT-5.6 एक्सेस के बिना खाता | openai/gpt-5.5 |
स्पष्ट पुनर्प्राप्ति विकल्प; OpenClaw चुपचाप डाउनग्रेड नहीं करता। |
| प्रत्यक्ष API-कुंजी बिलिंग, स्पष्ट OpenClaw रनटाइम | openai/gpt-5.6 और प्रदाता/मॉडल agentRuntime.id: "openclaw" |
सामान्य openai API-कुंजी प्रोफ़ाइल चुनें। |
| नवीनतम ChatGPT Instant मॉडल उपनाम | openai/chat-latest |
केवल प्रत्यक्ष API-कुंजी; बदलता हुआ उपनाम, स्थिर डिफ़ॉल्ट नहीं। |
| इमेज जनरेशन या संपादन | openai/gpt-image-2 |
OPENAI_API_KEY या Codex OAuth के साथ काम करता है। |
| पारदर्शी-पृष्ठभूमि वाली इमेज | openai/gpt-image-1.5 |
outputFormat को png या webp और background=transparent पर सेट करें। |
नामकरण मानचित्र
| दिखाई देने वाला नाम | परत | अर्थ |
|---|---|---|
openai |
प्रदाता उपसर्ग | प्रामाणिक OpenAI मॉडल रूट; रूट तथ्य अंतर्निहित रनटाइम निर्धारित करते हैं। |
codex Plugin |
Plugin | नेटिव Codex ऐप-सर्वर रनटाइम और /codex चैट नियंत्रण प्रदान करने वाला बंडल किया गया Plugin। |
प्रदाता/मॉडल agentRuntime.id: codex |
एजेंट रनटाइम | मेल खाने वाले एम्बेडेड टर्न के लिए नेटिव Codex ऐप-सर्वर हार्नेस को बाध्य करें। |
/codex ... |
चैट कमांड सेट | किसी वार्तालाप से Codex ऐप-सर्वर थ्रेड को बाइंड/नियंत्रित करें। |
runtime: "acp", agentId: "codex" |
ACP सत्र रूट | Codex को ACP/acpx के माध्यम से चलाने वाला स्पष्ट फ़ॉलबैक पथ। |
अंतर्निहित एजेंट रनटाइम
जब प्रदाता/मॉडल agentRuntime नीति अनिर्धारित या auto होती है, तब OpenAI की
प्रदाता-स्वामित्व वाली रूट नीति प्रभावी एंडपॉइंट और अडैप्टर से अंतर्निहित रनटाइम
चुनती है:
| प्रभावी रूट तथ्य | अंतर्निहित रनटाइम |
|---|---|
openai-responses वाला सटीक आधिकारिक Platform HTTPS एंडपॉइंट, या openai-chatgpt-responses वाला सटीक आधिकारिक ChatGPT HTTPS एंडपॉइंट; कोई लिखित अनुरोध ओवरराइड नहीं |
Codex चुना जा सकता है |
लिखित openai-completions अडैप्टर |
OpenClaw |
| कस्टम एंडपॉइंट | OpenClaw |
| HTTP का उपयोग करने वाला स्पष्ट, सटीक आधिकारिक एंडपॉइंट | अस्वीकृत |
| लिखित प्रदाता/मॉडल अनुरोध ओवरराइड वाला रूट | OpenClaw |
स्पष्ट गैर-डिफ़ॉल्ट प्रदाता/मॉडल agentRuntime.id प्रामाणिक बना रहता है।
उदाहरण के लिए, agentRuntime.id: "openclaw" अन्यथा Codex-योग्य
रूट को OpenClaw पर बनाए रखता है, जबकि agentRuntime.id: "codex" Codex को अनिवार्य करता है और
प्रभावी रूट के Codex-संगत घोषित न होने पर बंद रहते हुए विफल होता है।
रनटाइम चयन क्रेडेंशियल प्रकार या बिलिंग नहीं बदलता: Platform API-कुंजी
प्रमाणीकरण और ChatGPT/Codex सदस्यता प्रमाणीकरण अलग बने रहते हैं।
openclaw doctor --fix लेगेसी codex/* और openai-codex/* मॉडल
संदर्भों, लेगेसी Codex प्रमाणीकरण प्रोफ़ाइल आईडी और लेगेसी Codex प्रमाणीकरण-क्रम प्रविष्टियों को
प्रामाणिक openai रूट में माइग्रेट करता है। माइग्रेट किए गए मॉडल संदर्भों को मॉडल-स्कोप वाला
agentRuntime.id: "codex" मिलता है; नए प्रमाणीकरण-क्रम कॉन्फ़िगरेशन के लिए auth.order.openai का उपयोग करें।
GPT-5.6 सीमित पूर्वावलोकन
OpenClaw सटीक openai/gpt-5.6-sol,
openai/gpt-5.6-terra और openai/gpt-5.6-luna मॉडल आईडी पहचानता है। वर्तमान कैटलॉग में तीनों
xhigh और max रीजनिंग प्रदान करते हैं। OpenAI Sol को
प्रमुख टियर, Terra को संतुलित टियर और Luna को तेज़,
कम-लागत वाला टियर बताता है। देखें
GPT-5.6 लॉन्च घोषणा
और एक्सेस मार्गदर्शिका।
प्रत्यक्ष OpenAI API-कुंजी प्रमाणीकरण के साथ, केवल openai/gpt-5.6 आईडी Sol का उपनाम है
और नए सेटअप का डिफ़ॉल्ट है। नेटिव Codex कैटलॉग उस प्रत्यक्ष-API उपनाम को
क्लाइंट-पक्ष पर लागू नहीं करता; कार्यक्षेत्र एक्सेस के आधार पर, यह
सटीक Sol, Terra और Luna आईडी दिखा सकता है। इसलिए नया ChatGPT/Codex OAuth सेटअप
openai/gpt-5.6-sol का उपयोग करता है। वर्तमान खाते की जाँच इसके साथ करें:
openclaw models list --provider openaiAPI संगठन और Codex कार्यक्षेत्र एक्सेस अलग हो सकते हैं। यदि GPT-5.6 उपलब्ध नहीं है, तो GPT-5.5 को स्पष्ट रूप से चुनें:
openclaw models set openai/gpt-5.5OpenClaw अपस्ट्रीम एक्सेस त्रुटि दिखाता है और GPT-5.6 चयन को चुपचाप GPT-5.5 से प्रतिस्थापित नहीं करता।
OpenClaw फ़ीचर कवरेज
| OpenAI क्षमता | OpenClaw सतह | स्थिति |
|---|---|---|
| चैट / Responses | openai/<model> मॉडल प्रदाता |
हाँ |
| Codex सदस्यता मॉडल | OpenAI OAuth के साथ openai/<model> |
हाँ |
| पुराने Codex मॉडल संदर्भ | पुराने Codex मॉडल संदर्भ, codex-cli/<model> |
doctor द्वारा openai/<model> में सुधारे जाते हैं |
| Codex app-server हार्नेस | runtime unset/auto वाला Codex-संगत HTTPS रूट, या स्पष्ट agentRuntime.id: codex |
हाँ |
| सर्वर-साइड वेब खोज | मूल OpenAI Responses टूल | हाँ, जब वेब खोज सक्षम हो और कोई अन्य प्रदाता पिन न किया गया हो |
| छवियाँ | image_generate |
हाँ |
| वीडियो | video_generate |
हाँ |
| टेक्स्ट-टू-स्पीच | tts.provider: "openai" / tts |
हाँ |
| बैच स्पीच-टू-टेक्स्ट | tools.media.audio / मीडिया समझ |
हाँ |
| स्ट्रीमिंग स्पीच-टू-टेक्स्ट | Voice Call streaming.provider: "openai" |
हाँ |
| रीयलटाइम वॉइस | Voice Call realtime.provider: "openai" / Control UI Talk talk.realtime.provider: "openai" |
हाँ (OpenAI Platform API कुंजी) |
| एम्बेडिंग | मेमोरी एम्बेडिंग प्रदाता | हाँ |
मेमोरी एम्बेडिंग
OpenClaw, memory_search इंडेक्सिंग और क्वेरी एम्बेडिंग के लिए
OpenAI या OpenAI-संगत एम्बेडिंग एंडपॉइंट का उपयोग कर सकता है:
{ memory: { search: { provider: "openai", model: "text-embedding-3-small", }, },}असममित एम्बेडिंग लेबल की आवश्यकता वाले OpenAI-संगत एंडपॉइंट के लिए,
memory.search के अंतर्गत queryInputType और documentInputType सेट करें। OpenClaw
इन्हें प्रदाता-विशिष्ट input_type अनुरोध फ़ील्ड के रूप में अग्रेषित करता है: क्वेरी
एम्बेडिंग queryInputType का उपयोग करती हैं; इंडेक्स किए गए मेमोरी खंड और बैच इंडेक्सिंग
documentInputType का उपयोग करते हैं। संपूर्ण उदाहरण के लिए
मेमोरी कॉन्फ़िगरेशन संदर्भ
देखें।
आरंभ करना
API कुंजी (OpenAI Platform)
इसके लिए सर्वोत्तम: प्रत्यक्ष API पहुँच और उपयोग-आधारित बिलिंग।
अपनी API कुंजी प्राप्त करें
OpenAI Platform डैशबोर्ड से API कुंजी बनाएँ या कॉपी करें।
ऑनबोर्डिंग चलाएँ
openclaw onboard --auth-choice openai-api-keyया कुंजी सीधे दें:
openclaw onboard --openai-api-key "$OPENAI_API_KEY"सत्यापित करें कि मॉडल उपलब्ध है
openclaw models list --provider openaiरूट सारांश
| मॉडल संदर्भ | runtime नीति या रूट संबंधी तथ्य | रूट | प्रमाणीकरण |
|---|---|---|---|
openai/gpt-5.6 |
unset/auto, सटीक आधिकारिक HTTPS मूल रूट, कोई अनुरोध ओवरराइड नहीं |
Codex चुना जा सकता है | क्रमबद्ध API-कुंजी प्रमाणीकरण प्रोफ़ाइल |
openai/gpt-5.6 |
प्रदाता/मॉडल agentRuntime.id: "openclaw" |
OpenClaw अंतर्निहित runtime | चयनित openai API-कुंजी प्रोफ़ाइल |
openai/gpt-5.5 |
स्पष्ट प्रदाता/मॉडल agentRuntime.id |
चयनित एजेंट runtime | चयनित OpenAI API-कुंजी प्रोफ़ाइल |
openai/* |
लिखित Completions, कस्टम या अनुरोध ओवरराइड | OpenClaw अंतर्निहित runtime | क्रेडेंशियल प्रकार अपरिवर्तित रहता है |
openai/* |
प्लेनटेक्स्ट आधिकारिक HTTP एंडपॉइंट | अस्वीकृत | क्रेडेंशियल नहीं भेजा जाता |
कॉन्फ़िगरेशन उदाहरण
{ env: { OPENAI_API_KEY: "example-openai-key-not-real" }, agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}केवल प्रत्यक्ष-API वाला gpt-5.6 id, Sol टियर में रिज़ॉल्व होता है। यदि यह API
संगठन GPT-5.6 उपलब्ध नहीं कराता, तो primary को स्पष्ट रूप से
openai/gpt-5.5 पर सेट करें।
OpenAI API से ChatGPT का वर्तमान Instant मॉडल आज़माने के लिए, मॉडल को
openai/chat-latest पर सेट करें:
{ env: { OPENAI_API_KEY: "example-openai-key-not-real" }, agents: { defaults: { model: { primary: "openai/chat-latest" } } },}chat-latest एक बदलता हुआ उपनाम है। इसके बजाय नया OpenAI API-कुंजी सेटअप
openai/gpt-5.6 का उपयोग करता है, जिसका केवल प्रत्यक्ष-API वाला id Sol में रिज़ॉल्व होता है। मौजूदा
स्पष्ट primary, जिनमें openai/gpt-5.5 भी शामिल है, अपरिवर्तित रहते हैं।
chat-latest उपनाम केवल medium टेक्स्ट वर्बोसिटी स्वीकार करता है; इस मॉडल के लिए OpenClaw
अनुरोध की गई किसी भी अन्य वर्बोसिटी को बलपूर्वक medium पर सेट करता है।
Codex सदस्यता
इसके लिए सर्वोत्तम: अलग API कुंजी के बजाय मूल Codex app-server निष्पादन के साथ अपनी ChatGPT/Codex सदस्यता का उपयोग करना। Codex क्लाउड के लिए ChatGPT साइन-इन आवश्यक है।
Codex OAuth चलाएँ
openclaw onboard --auth-choice openaiया OAuth सीधे चलाएँ:
openclaw models auth login --provider openaiहेडलेस या कॉलबैक-विरोधी सेटअप के लिए, localhost ब्राउज़र कॉलबैक के बजाय
ChatGPT डिवाइस-कोड प्रवाह से साइन इन करने हेतु --device-code जोड़ें:
openclaw models auth login --provider openai --device-codeप्रामाणिक OpenAI मॉडल रूट का उपयोग करें
openclaw config set agents.defaults.model.primary openai/gpt-5.6-solइस सटीक आधिकारिक HTTPS मूल रूट के लिए किसी runtime कॉन्फ़िगरेशन की आवश्यकता नहीं है। यह Codex app-server runtime को स्वचालित रूप से चुन सकता है, और उस runtime के चुने जाने पर OpenClaw बंडल किए गए Codex Plugin को स्थापित या सुधारता है।
सत्यापित करें कि Codex प्रमाणीकरण उपलब्ध है
openclaw models list --provider openaiGateway चलने के बाद, मूल app-server runtime को सत्यापित करने के लिए चैट में
/codex status या /codex models भेजें।
रूट सारांश
| मॉडल संदर्भ | runtime नीति या रूट संबंधी तथ्य | रूट | प्रमाणीकरण |
|---|---|---|---|
openai/gpt-5.6-sol |
unset/auto, सटीक आधिकारिक HTTPS मूल रूट, कोई अनुरोध ओवरराइड नहीं |
Codex चुना जा सकता है | Codex साइन-इन, या क्रमबद्ध openai प्रमाणीकरण प्रोफ़ाइल |
openai/gpt-5.6-terra |
unset/auto, सटीक आधिकारिक HTTPS मूल रूट, कोई अनुरोध ओवरराइड नहीं |
Codex चुना जा सकता है | कैटलॉग में Terra उपलब्ध होने पर Codex साइन-इन |
openai/gpt-5.6-luna |
unset/auto, सटीक आधिकारिक HTTPS मूल रूट, कोई अनुरोध ओवरराइड नहीं |
Codex चुना जा सकता है | कैटलॉग में Luna उपलब्ध होने पर Codex साइन-इन |
openai/gpt-5.6-sol |
प्रदाता/मॉडल agentRuntime.id: "openclaw" |
OpenClaw अंतर्निहित runtime, आंतरिक Codex-प्रमाणीकरण ट्रांसपोर्ट | चयनित openai OAuth प्रोफ़ाइल |
openai/gpt-5.5 |
स्पष्ट प्रदाता/मॉडल agentRuntime.id |
चयनित एजेंट runtime | चयनित OpenAI प्रमाणीकरण प्रोफ़ाइल |
openai/* |
लिखित Completions, कस्टम या अनुरोध ओवरराइड | OpenClaw अंतर्निहित runtime | क्रेडेंशियल आवश्यकता रूट-विशिष्ट रहती है |
openai/* |
प्लेनटेक्स्ट आधिकारिक HTTP एंडपॉइंट | अस्वीकृत | क्रेडेंशियल नहीं भेजा जाता |
| पुराना Codex GPT-5.5 संदर्भ | doctor द्वारा सुधारा जाता है | openai/gpt-5.5 में पुनर्लिखित |
माइग्रेट किया गया OpenAI OAuth प्रोफ़ाइल |
codex-cli/gpt-5.5 |
doctor द्वारा सुधारा जाता है | openai/gpt-5.5 में पुनर्लिखित |
Codex app-server प्रमाणीकरण |
कॉन्फ़िगरेशन उदाहरण
{ plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.6-sol" }, }, },}API-कुंजी बैकअप के साथ, चयनित मॉडल को openai/* के अंतर्गत रखें और
प्रमाणीकरण क्रम को openai के अंतर्गत रखें। OpenClaw पहले सदस्यता, फिर
API कुंजी आज़माता है और इस दौरान Codex हार्नेस पर बना रहता है:
{ plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.6-sol" }, }, }, auth: { order: { openai: [ "openai:user@example.com", "openai:api-key-backup", ], }, },}Codex OAuth रूटिंग की जाँच और पुनर्प्राप्ति
openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --jsonकिसी विशिष्ट एजेंट के लिए --agent <id> जोड़ें:
openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openaiयदि किसी पुराने कॉन्फ़िगरेशन में अब भी विरासती Codex GPT रेफ़ या स्पष्ट रनटाइम कॉन्फ़िगरेशन के बिना पुराना OpenAI रनटाइम सत्र पिन है, तो उसे सुधारें:
openclaw doctor --fixopenclaw config validateयदि models auth list --provider openai कोई उपयोग योग्य प्रोफ़ाइल नहीं दिखाता है, तो फिर से
साइन इन करें:
openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openaiएक ही एजेंट में एकाधिक Codex OAuth लॉगिन के लिए --profile-id का उपयोग करें, फिर
उन्हें प्रमाणीकरण क्रम या /model ...@<profileId> के माध्यम से नियंत्रित करें:
openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lainप्रोफ़ाइल क्रम पर निर्भर होने से पहले पुराने विरासती OpenAI Codex उपसर्ग वाले
प्रोफ़ाइल आईडी और क्रम प्रविष्टियों को माइग्रेट करने के लिए openclaw doctor --fix चलाएँ।
स्थिति संकेतक
चैट /status दिखाता है कि वर्तमान सत्र के लिए कौन-सा मॉडल रनटाइम
सक्रिय है। जब कोई योग्य अंतर्निहित रूट या स्पष्ट प्रदाता/मॉडल रनटाइम नीति
इसे चुनती है, तो बंडल किया गया Codex ऐप-सर्वर हार्नेस
Runtime: OpenAI Codex के रूप में दिखाई देता है।
Doctor चेतावनी
यदि विरासती Codex मॉडल रेफ़ या पुराने OpenAI रनटाइम पिन कॉन्फ़िगरेशन
या सत्र स्थिति में बने रहते हैं, तो जब तक OpenClaw स्पष्ट रूप से कॉन्फ़िगर न हो,
openclaw doctor --fix उन्हें Codex रनटाइम के साथ openai/* में पुनर्लिखता है।
कॉन्टेक्स्ट विंडो डिफ़ॉल्ट और लंबे कॉन्टेक्स्ट का वैकल्पिक चयन
OpenClaw मूल मॉडल क्षमता और सक्रिय रनटाइम बजट को अलग-अलग मानों के रूप में मानता है:
contextWindowप्रदाता की कुल मॉडल विंडो घोषित करता है।contextTokensयह सीमित करता है कि OpenClaw उस विंडो का कितना भाग सक्रिय इनपुट के लिए उपयोग करता है।
ChatGPT/Codex OAuth लाइव Codex खाता कैटलॉग का अनुसरण करता है। वर्तमान
कैटलॉग आम तौर पर GPT-5.6 के लिए 272000 टोकन की सक्रिय विंडो
उपलब्ध बताता है। प्रत्यक्ष API-कुंजी वाले GPT-5.5 और GPT-5.6 मॉडल भी
272000 contextTokens पर डिफ़ॉल्ट होते हैं, भले ही Platform API
एक बड़ी मूल विंडो उपलब्ध कराता हो। इससे प्रमाणीकरण मोड में सामान्य विलंबता,
गुणवत्ता और लागत प्रोफ़ाइल सुसंगत रहती है। कॉन्फ़िगर किया गया
agents.defaults.contextTokens मान उस बजट को और कम कर सकता है, लेकिन यह किसी मॉडल को उसकी
कॉन्फ़िगर की गई contextTokens सीमा से ऊपर नहीं बढ़ा सकता।
प्रत्यक्ष API-कुंजी वाले GPT-5.5 और GPT-5.6 के लिए, OpenAI
1050000 टोकन की प्रदाता विंडो और 128000 अधिकतम आउटपुट
टोकन का दस्तावेज़ीकरण करता है। पूर्ण आउटपुट भत्ता आरक्षित करने पर इनपुट के लिए
922000 टोकन बचते हैं। यह व्युत्पन्न संचालन बजट है, प्रदाता द्वारा
प्रकाशित कोई अलग इनपुट सीमा नहीं। आधिकारिक मॉडल तुलना
और GPT-5.5 मॉडल पृष्ठ देखें।
निम्न उदाहरण एक Terra मॉडल के लिए उस भत्ते का वैकल्पिक चयन करता है और
OpenAI से 700000 सक्रिय टोकन पर संक्षिप्तीकरण करने को कहता है:
{ models: { providers: { openai: { models: [ { id: "gpt-5.6-terra", name: "GPT-5.6 Terra", contextWindow: 1050000, contextTokens: 922000, maxTokens: 128000, }, ], }, }, }, agents: { defaults: { model: { primary: "openai/gpt-5.6-terra" }, models: { "openai/gpt-5.6-terra": { agentRuntime: { id: "openclaw" }, params: { responsesServerCompaction: true, responsesCompactThreshold: 700000, }, }, }, }, },}इस उदाहरण में agentRuntime.id: "openclaw" जानबूझकर रखा गया है। यह सिद्ध करता है कि
अंतर्निहित OpenClaw Responses पथ ऊपर दिए मॉडल मेटाडेटा और सर्वर-पक्ष
संक्षिप्तीकरण सेटिंग का उपयोग कर रहा है। इसके बजाय, मूल Codex हार्नेस थ्रेड
अपने कॉन्टेक्स्ट बजट को Codex कॉन्फ़िगरेशन में नियंत्रित करता है; देखें
Codex हार्नेस लंबा कॉन्टेक्स्ट।
कैटलॉग पुनर्प्राप्ति
उपलब्ध होने पर OpenClaw gpt-5.5 के लिए अपस्ट्रीम Codex कैटलॉग
मेटाडेटा का उपयोग करता है। यदि खाता प्रमाणित होने के बावजूद लाइव Codex खोज
gpt-5.5 पंक्ति छोड़ देती है, तो OpenClaw उस OAuth मॉडल पंक्ति को
संश्लेषित करता है, ताकि Cron, उप-एजेंट और कॉन्फ़िगर किए गए डिफ़ॉल्ट-मॉडल रन
Unknown model के कारण विफल न हों।
मूल Codex ऐप-सर्वर प्रमाणीकरण
जब कोई योग्य सटीक आधिकारिक HTTPS रूट इसे अंतर्निहित रूप से चुनता है, या जब
प्रदाता/मॉडल agentRuntime.id: "codex" इसे स्पष्ट रूप से चुनता है, तब मूल Codex
ऐप-सर्वर हार्नेस openai/* मॉडल रेफ़ का उपयोग करता है। इसका प्रमाणीकरण
फिर भी खाते पर आधारित होता है। OpenClaw इस क्रम में प्रमाणीकरण चुनता है:
- एजेंट के लिए क्रमबद्ध OpenAI प्रमाणीकरण प्रोफ़ाइल, अधिमानतः
auth.order.openaiके अंतर्गत। पुराने विरासती Codex प्रमाणीकरण प्रोफ़ाइल आईडी और प्रमाणीकरण क्रम को माइग्रेट करने के लिएopenclaw doctor --fixचलाएँ। - ऐप-सर्वर का मौजूदा खाता, जैसे स्थानीय Codex CLI ChatGPT साइन-इन। डिफ़ॉल्ट पृथक एजेंट होम के लिए, OpenClaw उस मूल CLI खाते को उसके लॉगिन RPC के माध्यम से ऐप-सर्वर में जोड़ता है; यह CLI के कॉन्फ़िगरेशन, plugins या थ्रेड स्टोर को साझा नहीं करता।
- केवल स्थानीय stdio ऐप-सर्वर लॉन्च के लिए, और केवल तब जब ऐप-सर्वर
कोई खाता रिपोर्ट न करे:
CODEX_API_KEY, फिरOPENAI_API_KEY।
स्थानीय ChatGPT/Codex सदस्यता साइन-इन को केवल इसलिए प्रतिस्थापित नहीं किया जाता
क्योंकि Gateway प्रक्रिया में प्रत्यक्ष OpenAI मॉडल या एम्बेडिंग के लिए
OPENAI_API_KEY भी मौजूद है। env API-कुंजी फ़ॉलबैक केवल स्थानीय stdio
बिना-खाता पथ पर लागू होता है; इसे WebSocket ऐप-सर्वर कनेक्शन पर कभी नहीं भेजा
जाता। सदस्यता-शैली की Codex प्रोफ़ाइल चुने जाने पर, OpenClaw उत्पन्न की गई
stdio ऐप-सर्वर चाइल्ड प्रक्रिया से CODEX_API_KEY और OPENAI_API_KEY को भी
बाहर रखता है और इसके बजाय ऐप-सर्वर लॉगिन RPC के माध्यम से चयनित क्रेडेंशियल
भेजता है।
जब वह सदस्यता प्रोफ़ाइल Codex उपयोग सीमा के कारण अवरुद्ध होती है, तो OpenClaw
प्रोफ़ाइल को Codex द्वारा बताए गए रीसेट समय तक अवरुद्ध चिह्नित करता है और चयनित
मॉडल को बदले या Codex हार्नेस से बाहर निकले बिना प्रमाणीकरण क्रम को अगली
openai:* प्रोफ़ाइल पर घुमाने देता है। रीसेट समय बीतने के बाद सदस्यता
प्रोफ़ाइल फिर से योग्य हो जाती है।
छवि निर्माण
बंडल किया गया openai plugin image_generate टूल के माध्यम से
छवि निर्माण पंजीकृत करता है। यह समान openai/gpt-image-2 मॉडल रेफ़ के माध्यम से
OpenAI API-कुंजी और Codex OAuth, दोनों से छवि निर्माण का समर्थन करता है।
| क्षमता | OpenAI API कुंजी | Codex OAuth |
|---|---|---|
| मॉडल रेफ़ | openai/gpt-image-2 |
openai/gpt-image-2 |
| प्रमाणीकरण | OPENAI_API_KEY |
OpenAI Codex OAuth साइन-इन |
| परिवहन | OpenAI Images API | Codex Responses बैकएंड |
| प्रति अनुरोध अधिकतम छवियाँ | 4 | 4 |
| संपादन मोड | सक्षम (अधिकतम 5 संदर्भ छवियाँ) | सक्षम (अधिकतम 5 संदर्भ छवियाँ) |
| आकार ओवरराइड | समर्थित, 2K/4K आकार सहित | समर्थित, 2K/4K आकार सहित |
| अभिमुखता अनुपात / रिज़ॉल्यूशन | OpenAI Images API को अग्रेषित नहीं किया जाता | सुरक्षित होने पर समर्थित आकार से मैप किया जाता है |
{ agents: { defaults: { imageGenerationModel: { primary: "openai/gpt-image-2" }, }, },}OpenAI टेक्स्ट-से-छवि निर्माण और छवि संपादन के लिए gpt-image-2
डिफ़ॉल्ट है। gpt-image-1.5, gpt-image-1 और gpt-image-1-mini स्पष्ट
मॉडल ओवरराइड के रूप में उपयोग योग्य रहते हैं। पारदर्शी-पृष्ठभूमि PNG/WebP
आउटपुट के लिए openai/gpt-image-1.5 का उपयोग करें; वर्तमान gpt-image-2 API
background: "transparent" को अस्वीकार करता है।
पारदर्शी-पृष्ठभूमि अनुरोध के लिए, model: "openai/gpt-image-1.5", outputFormat: "png" या
"webp", और background: "transparent" के साथ image_generate को कॉल करें;
पुराना openai.background प्रदाता विकल्प अब भी स्वीकार किया जाता है। OpenClaw
डिफ़ॉल्ट openai/gpt-image-2 पारदर्शी अनुरोधों को gpt-image-1.5 में
पुनर्लिखकर सार्वजनिक OpenAI और OpenAI Codex OAuth रूट की भी सुरक्षा करता है;
Azure और कस्टम OpenAI-संगत एंडपॉइंट अपने कॉन्फ़िगर किए गए परिनियोजन/मॉडल नाम
बनाए रखते हैं।
हेडलेस CLI रन के लिए भी यही सेटिंग उपलब्ध है:
openclaw infer image generate \ --model openai/gpt-image-1.5 \ --output-format png \ --background transparent \ --prompt "पारदर्शी पृष्ठभूमि पर एक साधारण लाल वृत्त वाला स्टिकर" \ --jsonइनपुट फ़ाइल से शुरू करते समय openclaw infer image edit के साथ समान
--output-format और --background फ़्लैग का उपयोग करें।
--openai-background OpenAI-विशिष्ट उपनाम के रूप में उपलब्ध रहता है। OpenAI
Images की गुणवत्ता और लागत नियंत्रित करने के लिए --quality low|medium|high|auto का उपयोग
करें। image generate या image edit में से OpenAI का मॉडरेशन संकेत
पास करने के लिए --openai-moderation low|auto का उपयोग करें।
ChatGPT/Codex OAuth इंस्टॉल के लिए, वही openai/gpt-image-2 संदर्भ रखें। जब
कोई openai OAuth प्रोफ़ाइल कॉन्फ़िगर की जाती है, तो OpenClaw उस संग्रहीत OAuth
एक्सेस टोकन को प्राप्त करता है और Codex Responses बैकएंड के माध्यम से इमेज अनुरोध भेजता है; यह
पहले OPENAI_API_KEY को आज़माता नहीं है और न ही चुपचाप किसी API कुंजी पर फ़ॉलबैक करता है।
जब इसके बजाय सीधे OpenAI Images API रूट का उपयोग करना हो, तो models.providers.openai को
API कुंजी, कस्टम बेस URL या Azure एंडपॉइंट के साथ स्पष्ट रूप से कॉन्फ़िगर करें।
यदि वह कस्टम इमेज एंडपॉइंट किसी विश्वसनीय LAN/निजी पते पर है, तो
browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true भी सेट करें; यह ऑप्ट-इन मौजूद न होने पर OpenClaw
निजी/आंतरिक OpenAI-संगत इमेज एंडपॉइंट को अवरुद्ध रखता है।
जनरेट करें:
/tool image_generate model=openai/gpt-image-2 prompt="macOS पर OpenClaw के लिए एक परिष्कृत लॉन्च पोस्टर" size=3840x2160 count=1पारदर्शी PNG जनरेट करें:
/tool image_generate model=openai/gpt-image-1.5 prompt="पारदर्शी पृष्ठभूमि पर एक साधारण लाल वृत्ताकार स्टिकर" outputFormat=png background=transparentसंपादित करें:
/tool image_generate model=openai/gpt-image-2 prompt="वस्तु का आकार बनाए रखें, सामग्री को पारभासी काँच में बदलें" image=/path/to/reference.png size=1024x1536वीडियो जनरेशन
बंडल किया गया openai Plugin
video_generate टूल के माध्यम से वीडियो जनरेशन पंजीकृत करता है।
| क्षमता | मान |
|---|---|
| डिफ़ॉल्ट मॉडल | openai/sora-2 |
| मोड | टेक्स्ट-से-वीडियो, इमेज-से-वीडियो, एकल-वीडियो संपादन |
| संदर्भ इनपुट | 1 इमेज या 1 वीडियो |
| आकार ओवरराइड | टेक्स्ट-से-वीडियो और इमेज-से-वीडियो के लिए समर्थित |
| आस्पेक्ट रेशियो | निकटतम समर्थित आकार में परिवर्तित किया जाता है, मूल रूप में अग्रेषित नहीं किया जाता |
| अन्य ओवरराइड | resolution, audio, watermark असमर्थित हैं और टूल चेतावनी के साथ हटा दिए जाते हैं |
OpenAI के इमेज-से-वीडियो अनुरोध इमेज
input_reference के साथ POST /v1/videos का उपयोग करते हैं।
एकल-वीडियो संपादन, अपलोड किए गए वीडियो को video फ़ील्ड में रखकर
POST /v1/videos/edits का उपयोग करते हैं।
{ agents: { defaults: { videoGenerationModel: { primary: "openai/sora-2" }, }, },}GPT-5 प्रॉम्प्ट योगदान
OpenClaw, openai प्रदाता पर GPT-5-फ़ैमिली मॉडल के लिए एक साझा GPT-5
प्रॉम्प्ट योगदान जोड़ता है (इसमें मरम्मत से पहले के पुराने Codex संदर्भ भी शामिल हैं, जो
openai/* में नॉर्मलाइज़ होते हैं)। OpenRouter या opencode रूट जैसे अन्य प्रदाता,
जो GPT-5-फ़ैमिली मॉडल आईडी भी उपलब्ध कराते हैं, यह ओवरले प्राप्त नहीं करते; यह केवल मॉडल आईडी
पर नहीं, बल्कि प्रदाता आईडी openai पर आधारित है। पुराने GPT-4.x मॉडल इसे कभी
प्राप्त नहीं करते।
मूल Codex ऐप-सर्वर हार्नेस, डेवलपर निर्देशों के माध्यम से पर्सोना/टूल-अनुशासन व्यवहार अनुबंध या मैत्रीपूर्ण इंटरैक्शन-शैली ओवरले प्राप्त नहीं करता; मूल Codex, Codex के स्वामित्व वाले बेस, मॉडल और प्रोजेक्ट-दस्तावेज़ व्यवहार को बनाए रखता है, और OpenClaw मूल थ्रेड के लिए Codex की अंतर्निहित पर्सनैलिटी अक्षम करता है, ताकि एजेंट कार्यस्थान की पर्सनैलिटी फ़ाइलें आधिकारिक बनी रहें। OpenClaw मूल Codex थ्रेड में केवल रनटाइम संदर्भ का योगदान देता है: चैनल डिलीवरी, OpenClaw डायनेमिक टूल, ACP डेलिगेशन, कार्यस्थान संदर्भ और OpenClaw Skills। इसी योगदान का Heartbeat-मार्गदर्शन टेक्स्ट एकमात्र अपवाद है: मूल Codex Heartbeat टर्न को यह मिलता है, जिसे साझा प्रॉम्प्ट-योगदान हुक के बजाय समर्पित सहयोग निर्देशों के रूप में इंजेक्ट किया जाता है।
GPT-5 योगदान मेल खाने वाले OpenClaw-संयोजित प्रॉम्प्ट में पर्सोना स्थायित्व, निष्पादन सुरक्षा, टूल अनुशासन, आउटपुट आकार, पूर्णता जाँच और सत्यापन के लिए टैग किया गया व्यवहार अनुबंध जोड़ता है। चैनल-विशिष्ट उत्तर और मौन-संदेश व्यवहार साझा OpenClaw सिस्टम प्रॉम्प्ट और आउटबाउंड डिलीवरी नीति में रहते हैं। मैत्रीपूर्ण इंटरैक्शन-शैली परत अलग और कॉन्फ़िगर करने योग्य है।
| मान | प्रभाव |
|---|---|
"friendly" (डिफ़ॉल्ट) |
मैत्रीपूर्ण इंटरैक्शन-शैली परत सक्षम करें |
"on" |
"friendly" का उपनाम |
"off" |
केवल मैत्रीपूर्ण शैली परत अक्षम करें |
कॉन्फ़िगरेशन
{ agents: { defaults: { promptOverlays: { gpt5: { personality: "friendly" }, }, }, },}CLI
openclaw config set agents.defaults.promptOverlays.gpt5.personality offआवाज़ और वाणी
वाणी संश्लेषण (TTS)
बंडल किया गया openai Plugin,
tts सतह के लिए वाणी संश्लेषण पंजीकृत करता है।
| सेटिंग | कॉन्फ़िगरेशन पथ | डिफ़ॉल्ट |
|---|---|---|
| मॉडल | tts.providers.openai.model |
gpt-4o-mini-tts |
| आवाज़ | tts.providers.openai.speakerVoice |
coral |
| गति | tts.providers.openai.speed |
(अनसेट) |
| निर्देश | tts.providers.openai.instructions |
(अनसेट, केवल gpt-4o-mini-tts) |
| प्रारूप | tts.providers.openai.responseFormat |
वॉइस नोट के लिए opus, फ़ाइलों के लिए mp3 |
| API कुंजी | tts.providers.openai.apiKey |
OPENAI_API_KEY पर फ़ॉलबैक करता है |
| बेस URL | tts.providers.openai.baseUrl |
https://api.openai.com/v1 |
| अतिरिक्त बॉडी | tts.providers.openai.extraBody / extra_body |
(अनसेट) |
उपलब्ध मॉडल: gpt-4o-mini-tts, tts-1, tts-1-hd। उपलब्ध आवाज़ें:
alloy, ash, ballad, cedar, coral, echo, fable, juniper,
marin, onyx, nova, sage, shimmer, verse।
extraBody को OpenClaw द्वारा जनरेट किए गए फ़ील्ड के बाद /audio/speech
अनुरोध JSON में मर्ज किया जाता है, इसलिए इसका उपयोग उन OpenAI-संगत एंडपॉइंट के लिए करें
जिन्हें lang जैसी अतिरिक्त कुंजियों की आवश्यकता होती है। प्रोटोटाइप कुंजियों
को अनदेखा किया जाता है।
{ tts: { providers: { openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" }, }, },}वाणी-से-टेक्स्ट
बंडल किया गया openai Plugin, OpenClaw की मीडिया-अंडरस्टैंडिंग
ट्रांसक्रिप्शन सतह के माध्यम से बैच वाणी-से-टेक्स्ट पंजीकृत करता है।
- डिफ़ॉल्ट मॉडल:
gpt-4o-transcribe - एंडपॉइंट: OpenAI REST
/v1/audio/transcriptions - इनपुट पथ: मल्टीपार्ट ऑडियो फ़ाइल अपलोड
- जहाँ भी इनबाउंड ऑडियो ट्रांसक्रिप्शन
tools.media.audioको पढ़ता है, वहाँ उपयोग किया जाता है, जिसमें Discord वॉइस-चैनल सेगमेंट और चैनल ऑडियो अटैचमेंट शामिल हैं
इनबाउंड ऑडियो ट्रांसक्रिप्शन के लिए OpenAI को बाध्य करने हेतु:
{ tools: { media: { audio: { models: [ { type: "provider", provider: "openai", model: "gpt-4o-transcribe", }, ], }, }, },}साझा ऑडियो मीडिया कॉन्फ़िगरेशन या प्रति-कॉल ट्रांसक्रिप्शन अनुरोध द्वारा दिए जाने पर भाषा और प्रॉम्प्ट संकेत OpenAI को अग्रेषित किए जाते हैं।
Realtime ट्रांसक्रिप्शन
बंडल किया गया openai Plugin, Voice Call Plugin के लिए
Realtime ट्रांसक्रिप्शन पंजीकृत करता है।
| सेटिंग | कॉन्फ़िगरेशन पथ | डिफ़ॉल्ट |
|---|---|---|
| मॉडल | plugins.entries.voice-call.config.streaming.providers.openai.model |
gpt-4o-transcribe |
| भाषा | ...openai.language |
(अनसेट) |
| प्रॉम्प्ट | ...openai.prompt |
(अनसेट) |
| मौन अवधि | ...openai.silenceDurationMs |
800 |
| VAD थ्रेशोल्ड | ...openai.vadThreshold |
0.5 |
| प्रमाणीकरण | ...openai.apiKey, OPENAI_API_KEY, या openai API-कुंजी प्रोफ़ाइल |
Platform API कुंजी आवश्यक |
Realtime आवाज़
बंडल किया गया openai Plugin, Voice Call Plugin के लिए
Realtime आवाज़ पंजीकृत करता है।
| सेटिंग | कॉन्फ़िग पथ | डिफ़ॉल्ट |
|---|---|---|
| मॉडल | plugins.entries.voice-call.config.realtime.providers.openai.model |
gpt-realtime-2.1 |
| वॉइस | ...openai.voice |
alloy |
| तापमान (Azure डिप्लॉयमेंट ब्रिज) | ...openai.temperature |
0.8 |
| VAD थ्रेशोल्ड | ...openai.vadThreshold |
0.5 |
| मौन अवधि | ...openai.silenceDurationMs |
500 |
| प्रीफ़िक्स पैडिंग | ...openai.prefixPaddingMs |
300 |
| रीजनिंग प्रयास | ...openai.reasoningEffort |
(सेट नहीं) |
| प्रमाणीकरण | openai API-कुंजी प्रोफ़ाइल, ...openai.apiKey, या OPENAI_API_KEY |
OpenAI Platform API कुंजी आवश्यक |
gpt-realtime-2.1 के लिए उपलब्ध अंतर्निहित Realtime वॉइस: alloy, ash,
ballad, coral, echo, sage, shimmer, verse, marin, cedar।
सर्वोत्तम Realtime गुणवत्ता के लिए OpenAI marin और cedar की अनुशंसा करता है। यह
ऊपर दी गई टेक्स्ट-टू-स्पीच वॉइस से अलग सेट है; केवल TTS वाली वॉइस,
जैसे fable, nova, या onyx, Realtime सत्रों के लिए मान्य नहीं है।
यदि आप छोटे, कम लागत वाले Realtime 2.1 वेरिएंट को प्राथमिकता देते हैं, तो मॉडल को स्पष्ट रूप से
gpt-realtime-2.1-mini पर सेट करें।
Azure OpenAI एंडपॉइंट
बंडल किया गया openai प्रदाता बेस URL को ओवरराइड करके इमेज
जनरेशन के लिए Azure OpenAI संसाधन को लक्षित कर सकता है। इमेज-जनरेशन पथ पर, OpenClaw
models.providers.openai.baseUrl पर Azure होस्टनाम का पता लगाता है और
स्वचालित रूप से Azure की अनुरोध संरचना पर स्विच करता है।
Azure OpenAI का उपयोग तब करें जब:
- आपके पास पहले से Azure OpenAI सदस्यता, कोटा या एंटरप्राइज़ अनुबंध हो
- आपको क्षेत्रीय डेटा रेज़िडेंसी या Azure द्वारा प्रदान किए जाने वाले अनुपालन नियंत्रणों की आवश्यकता हो
- आप ट्रैफ़िक को मौजूदा Azure टेनेंसी के भीतर रखना चाहते हों
कॉन्फ़िगरेशन
बंडल किए गए openai प्रदाता के माध्यम से Azure इमेज जनरेशन के लिए,
models.providers.openai.baseUrl को अपने Azure संसाधन पर इंगित करें और apiKey को
Azure OpenAI कुंजी पर सेट करें (OpenAI Platform कुंजी पर नहीं):
{ models: { providers: { openai: { baseUrl: "https://<your-resource>.openai.azure.com", apiKey: "<azure-openai-api-key>", }, }, },}OpenClaw, Azure इमेज-जनरेशन रूट के लिए इन Azure होस्ट सफ़िक्स को पहचानता है:
*.openai.azure.com*.services.ai.azure.com*.cognitiveservices.azure.com
पहचाने गए Azure होस्ट पर इमेज-जनरेशन अनुरोधों के लिए, OpenClaw:
Authorization: Bearerके बजायapi-keyहेडर भेजता है- डिप्लॉयमेंट-स्कोप वाले पथों (
/openai/deployments/{deployment}/...) का उपयोग करता है - प्रत्येक अनुरोध में
?api-version=...जोड़ता है - Azure इमेज-जनरेशन कॉल के लिए 600s की डिफ़ॉल्ट अनुरोध टाइमआउट अवधि का उपयोग करता है।
प्रत्येक कॉल के
timeoutMsमान फिर भी इस डिफ़ॉल्ट को ओवरराइड करते हैं।
अन्य बेस URL (सार्वजनिक OpenAI, OpenAI-संगत प्रॉक्सी) मानक OpenAI इमेज अनुरोध संरचना बनाए रखते हैं।
API संस्करण
Azure इमेज-जनरेशन पथ के लिए किसी विशिष्ट Azure प्रीव्यू या GA संस्करण को
पिन करने हेतु AZURE_OPENAI_API_VERSION सेट करें:
export AZURE_OPENAI_API_VERSION="2024-12-01-preview"वेरिएबल सेट न होने पर डिफ़ॉल्ट 2024-12-01-preview है।
मॉडल नाम ही डिप्लॉयमेंट नाम हैं
Azure OpenAI मॉडल को डिप्लॉयमेंट से बाँधता है। बंडल किए गए
openai प्रदाता के माध्यम से रूट किए गए Azure इमेज-जनरेशन अनुरोधों के लिए, OpenClaw में
model फ़ील्ड वह Azure डिप्लॉयमेंट नाम होना चाहिए जिसे आपने Azure पोर्टल में
कॉन्फ़िगर किया है, न कि सार्वजनिक OpenAI मॉडल आईडी।
यदि आप gpt-image-2 प्रदान करने वाला gpt-image-2-prod नामक डिप्लॉयमेंट बनाते हैं:
/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1डिप्लॉयमेंट-नाम का यही नियम बंडल किए गए openai प्रदाता के माध्यम से
रूट की गई प्रत्येक इमेज-जनरेशन कॉल पर लागू होता है।
क्षेत्रीय उपलब्धता
Azure इमेज जनरेशन वर्तमान में केवल कुछ क्षेत्रों में उपलब्ध है
(उदाहरण के लिए eastus2, swedencentral, polandcentral, westus3,
uaenorth)। डिप्लॉयमेंट बनाने से पहले Microsoft की वर्तमान क्षेत्र सूची जाँचें
और पुष्टि करें कि विशिष्ट मॉडल आपके क्षेत्र में उपलब्ध है।
पैरामीटर अंतर
Azure OpenAI और सार्वजनिक OpenAI हमेशा समान इमेज पैरामीटर स्वीकार नहीं करते।
Azure उन विकल्पों को अस्वीकार कर सकता है जिनकी सार्वजनिक OpenAI अनुमति देता है (उदाहरण के लिए
gpt-image-2 पर कुछ background मान), या उन्हें केवल विशिष्ट मॉडल
संस्करणों पर उपलब्ध करा सकता है। ये अंतर Azure और अंतर्निहित मॉडल से आते हैं,
OpenClaw से नहीं। यदि कोई Azure अनुरोध सत्यापन त्रुटि के साथ विफल होता है, तो Azure पोर्टल में
अपने विशिष्ट डिप्लॉयमेंट और API संस्करण द्वारा समर्थित
पैरामीटर सेट जाँचें।
उन्नत कॉन्फ़िगरेशन
नीचे दिए गए प्रति-मॉडल params उदाहरण OpenClaw के एम्बेडेड प्रदाता
अनुरोध को आकार देते हैं। इन्हें कॉन्फ़िगर करना स्वयं निर्धारित अनुरोध व्यवहार है, इसलिए अन्यथा पात्र
auto रूट Codex को अंतर्निहित रूप से चुनने के बजाय OpenClaw पर ही रहता है। मूल
Codex ऐप-सर्वर हार्नेस अपने ट्रांसपोर्ट और अनुरोध सेटिंग का स्वामी है; प्रभावी रूट को
Codex-संगत घोषित न किए जाने पर स्पष्ट
agentRuntime.id: "codex" बंद अवस्था में विफल होता है।
ट्रांसपोर्ट (WebSocket बनाम SSE)
OpenClaw, openai/* के लिए SSE फ़ॉलबैक ("auto") के साथ WebSocket-प्रथम का उपयोग करता है।
"auto" मोड में, OpenClaw:
- SSE पर फ़ॉलबैक करने से पहले एक शुरुआती WebSocket विफलता पर दोबारा प्रयास करता है
- विफलता के बाद, WebSocket को 60 सेकंड के लिए अवनत चिह्नित करता है और कूल-डाउन के दौरान SSE का उपयोग करता है
- पुनः प्रयास और पुनः कनेक्शन के लिए स्थिर सत्र तथा टर्न पहचान हेडर संलग्न करता है
- ट्रांसपोर्ट वेरिएंट में उपयोग काउंटर (
input_tokens/prompt_tokens) को सामान्यीकृत करता है
| मान | व्यवहार |
|---|---|
"auto" (डिफ़ॉल्ट) |
पहले WebSocket, SSE फ़ॉलबैक |
"sse" |
केवल SSE बाध्य करें |
"websocket" |
केवल WebSocket बाध्य करें |
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { transport: "auto" }, }, }, }, },}संबंधित OpenAI दस्तावेज़:
तेज़ मोड
OpenClaw, openai/* के लिए एक साझा तेज़-मोड टॉगल उपलब्ध कराता है:
- चैट/UI:
/fast status|auto|on|off - कॉन्फ़िग:
agents.defaults.models["<provider>/<model>"].params.fastMode
सक्षम होने पर, OpenClaw तेज़ मोड को OpenAI प्राथमिकता प्रोसेसिंग
(service_tier = "priority") से मैप करता है। मौजूदा service_tier मान
सुरक्षित रखे जाते हैं, और तेज़ मोड reasoning या
text.verbosity को दोबारा नहीं लिखता। fastMode: "auto" स्वतः कटऑफ़ तक नए मॉडल कॉल
तेज़ मोड में शुरू करता है, फिर बाद के पुनः प्रयास, फ़ॉलबैक, टूल-परिणाम या
निरंतरता कॉल तेज़ मोड के बिना शुरू करता है। कटऑफ़ का डिफ़ॉल्ट 60 सेकंड है;
इसे बदलने के लिए सक्रिय मॉडल पर params.fastAutoOnSeconds सेट करें।
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } }, }, }, },}प्राथमिकता प्रोसेसिंग (service_tier)
OpenAI का API service_tier के माध्यम से प्राथमिकता प्रोसेसिंग उपलब्ध कराता है। इसे OpenClaw में
प्रत्येक मॉडल के लिए सेट करें:
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { serviceTier: "priority" } }, }, }, },}समर्थित मान: auto, default, flex, priority।
सर्वर-साइड Compaction (Responses API)
प्रत्यक्ष OpenAI Responses मॉडल (api.openai.com पर openai/*) के लिए,
OpenAI Plugin का OpenClaw स्ट्रीम रैपर सर्वर-साइड
Compaction को स्वतः सक्षम करता है:
store: trueको अनिवार्य करता है (जब तक मॉडल संगतताsupportsStore: falseसेट न करे)context_management: [{ type: "compaction", compact_threshold: ... }]अंतःक्षेपित करता है- डिफ़ॉल्ट
compact_threshold:contextWindowका 70% (या अनुपलब्ध होने पर80000)
यह अंतर्निहित OpenClaw रनटाइम पथ और एम्बेडेड रन द्वारा उपयोग किए जाने वाले OpenAI प्रदाता हुक पर लागू होता है। मूल Codex ऐप-सर्वर हार्नेस Codex के माध्यम से अपने कॉन्टेक्स्ट का प्रबंधन करता है और इस सेटिंग से प्रभावित नहीं होता।
स्पष्ट रूप से सक्षम करें
Azure OpenAI Responses जैसे संगत एंडपॉइंट के लिए उपयोगी:
{ agents: { defaults: { models: { "azure-openai-responses/gpt-5.5": { params: { responsesServerCompaction: true }, }, }, }, },}कस्टम सीमा
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { responsesServerCompaction: true, responsesCompactThreshold: 120000, }, }, }, }, },}अक्षम करें
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { responsesServerCompaction: false }, }, }, }, },}सख्त-एजेंटिक GPT मोड
OpenClaw के एम्बेडेड रनटाइम के माध्यम से चलने वाले openai प्रदाता के GPT-5-परिवार मॉडल के लिए,
OpenClaw पहले से ही strict-agentic नामक अधिक सख्त निष्पादन अनुबंध को
डिफ़ॉल्ट रूप से उपयोग करता है। जब भी समाधान किया गया प्रदाता
openai हो और मॉडल आईडी GPT-5 परिवार से मेल खाती हो, यह स्वतः सक्रिय हो जाता है, जब तक कॉन्फ़िगरेशन
स्पष्ट रूप से इससे बाहर निकलने का विकल्प न चुने:
{ agents: { defaults: { embeddedAgent: { executionContract: "default" }, }, },}"strict-agentic" को स्पष्ट रूप से सेट करने का समर्थित लेन पर कोई प्रभाव नहीं पड़ता (यह
पहले से ही डिफ़ॉल्ट है) और असमर्थित प्रदाता/मॉडल युग्मों पर यह निष्क्रिय रहता है।
strict-agentic सक्रिय होने पर, OpenClaw:
- पर्याप्त कार्य के लिए
update_planको स्वतः सक्षम करता है - संरचनात्मक रूप से खाली या केवल तर्क वाले टर्न को दृश्यमान-उत्तर निरंतरता के साथ पुनः प्रयास करता है
- चयनित हार्नेस द्वारा उपलब्ध कराए जाने पर स्पष्ट हार्नेस योजना इवेंट का उपयोग करता है
OpenClaw यह तय करने के लिए सहायक के गद्य को वर्गीकृत नहीं करता कि कोई टर्न योजना, प्रगति अपडेट या अंतिम उत्तर है।
मूल बनाम OpenAI-संगत रूट
OpenClaw प्रत्यक्ष OpenAI, Codex और Azure OpenAI एंडपॉइंट को
सामान्य OpenAI-संगत /v1 प्रॉक्सी से अलग तरीके से संभालता है:
मूल रूट (openai/*, Azure OpenAI):
reasoning: { effort: "none" }केवल उन मॉडलों के लिए रखता है जो OpenAInoneप्रयास का समर्थन करते हैं- उन मॉडलों या प्रॉक्सी के लिए अक्षम तर्क को छोड़ देता है जो
reasoning.effort: "none"को अस्वीकार करते हैं - टूल स्कीमा को डिफ़ॉल्ट रूप से सख्त मोड में रखता है
- छिपे हुए एट्रिब्यूशन हेडर केवल सत्यापित मूल होस्ट पर संलग्न करता है (Azure OpenAI को ये हेडर नहीं मिलते, भले ही वह एक मूल रूट हो)
- केवल-OpenAI अनुरोध आकार-निर्धारण (
service_tier,store, तर्क-संगतता, प्रॉम्प्ट-कैश संकेत) बनाए रखता है
प्रॉक्सी/संगत रूट:
- अधिक शिथिल संगतता व्यवहार का उपयोग करते हैं
- गैर-मूल
openai-completionsपेलोड से Completionsstoreहटाते हैं - OpenAI-संगत Completions प्रॉक्सी के लिए उन्नत
params.extra_body/params.extraBodyपास-थ्रू JSON स्वीकार करते हैं - vLLM जैसे OpenAI-संगत Completions
प्रॉक्सी के लिए
params.chat_template_kwargsस्वीकार करते हैं - सख्त टूल स्कीमा या केवल-मूल हेडर को अनिवार्य नहीं करते