---
read_when:
- आप OpenClaw में OpenAI मॉडल का उपयोग करना चाहते हैं
- आप API कुंजियों के बजाय Codex सदस्यता प्रमाणीकरण चाहते हैं
- आपको अधिक सख़्त GPT-5 एजेंट निष्पादन व्यवहार चाहिए
summary: OpenClaw में API कुंजियों या Codex सदस्यता के माध्यम से OpenAI का उपयोग करें
title: OpenAI
x-i18n:
generated_at: "2026-07-27T20:23:47Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 32
provider: openai
source_hash: 612a36760899e01126364ddca523f0a6340036253cf349ae2755ba15c6451ba6
source_path: providers/openai.md
workflow: 16
---
OpenClaw प्रत्यक्ष API-कुंजी प्रमाणीकरण और ChatGPT/Codex सदस्यता प्रमाणीकरण, दोनों के लिए एक ही प्रदाता आईडी, `openai`, का उपयोग करता है।
`openai/*` प्रामाणिक मॉडल रूट है।
रनटाइम नीति के अनिर्धारित या `auto` होने पर, एम्बेडेड एजेंट टर्न के लिए OpenAI के रूट
तथ्य तय करते हैं कि OpenClaw बंडल किए गए Codex ऐप-सर्वर रनटाइम को
अंतर्निहित रूप से चुन सकता है या नहीं। केवल `openai/*` उपसर्ग किसी रनटाइम का चयन नहीं करता।
- **एजेंट मॉडल** - स्पष्ट
`agentRuntime` कॉन्फ़िगरेशन या OpenAI की अंतर्निहित रूट नीति द्वारा चुने गए रनटाइम के माध्यम से `openai/*`। ChatGPT/Codex सदस्यता उपयोग के लिए Codex
प्रमाणीकरण से साइन इन करें, या कुंजी-आधारित बिलिंग चाहिए तो API-कुंजी प्रमाणीकरण
प्रोफ़ाइल कॉन्फ़िगर करें।
- **गैर-एजेंट OpenAI API** - `OPENAI_API_KEY` या किसी `openai` API-कुंजी प्रमाणीकरण प्रोफ़ाइल के माध्यम से, प्रति उपयोग बिल किए जाने वाला प्रत्यक्ष OpenAI Platform एक्सेस।
- **लेगेसी कॉन्फ़िगरेशन** - `codex/*` और `openai-codex/*` संदर्भों को
`openclaw doctor --fix` द्वारा `openai/*` और मॉडल-स्कोप वाले `agentRuntime.id: "codex"` में सुधारा जाता है।
OpenAI बाहरी टूल और OpenClaw जैसे वर्कफ़्लो में सदस्यता OAuth के उपयोग का स्पष्ट रूप से समर्थन करता है।
## उपयोग और लागत ट्रैकिंग
OpenClaw सदस्यता कोटा और Platform API बिलिंग को अलग रखता है:
- ChatGPT/Codex OAuth सदस्यता योजना, कोटा विंडो और क्रेडिट शेष दिखाता है।
- `OPENAI_ADMIN_KEY` Control UI के **उपयोग** में प्रदाता द्वारा रिपोर्ट की गई संगठन लागत और पूर्णताओं के 30 दिनों के उपयोग को दिखाता है, जिसमें दैनिक खर्च, अनुरोध/टोकन योग, शीर्ष मॉडल और लागत श्रेणियाँ शामिल हैं।
- `OPENAI_PROJECT_ID` वैकल्पिक रूप से Admin API इतिहास को किसी एक प्रोजेक्ट तक सीमित करता है।
- OpenClaw कभी भी `OPENAI_API_KEY` या किसी `openai` अनुमान प्रोफ़ाइल को संगठन API पर नहीं भेजता; वे क्रेडेंशियल कस्टम, Azure या एजेंट-स्थानीय एंडपॉइंट से संबंधित हो सकते हैं।
स्पष्ट Admin कुंजी को OAuth पर प्राथमिकता मिलती है। प्रदाता द्वारा रिपोर्ट किए गए इतिहास को OpenClaw की सत्र-व्युत्पन्न अनुमानित लागत के साथ मर्ज नहीं किया जाता; इसमें अन्य क्लाइंट की API गतिविधि और प्रदाता-पक्ष के बिलिंग समायोजन शामिल हो सकते हैं।
OpenAI का [API उपयोग डैशबोर्ड](https://help.openai.com/en/articles/10478918) दस्तावेज़ उपयोग डेटा के लिए संगठन-स्वामी और स्पष्ट Usage Dashboard अनुमति आवश्यकताओं का वर्णन करता है।
प्रदाता, मॉडल, रनटाइम और चैनल अलग-अलग परतें हैं। यदि ये लेबल
आपस में मिल रहे हैं, तो कॉन्फ़िगरेशन बदलने से पहले [एजेंट रनटाइम](/hi/concepts/agent-runtimes) पढ़ें।
## त्वरित चयन
| लक्ष्य | उपयोग करें | टिप्पणियाँ |
| ------------------------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------- |
| 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` का उपयोग करें।
नया OpenAI सेटअप केवल तभी GPT-5.6 प्राथमिक मॉडल लागू करता है, जब कोई प्राथमिक मॉडल
कॉन्फ़िगर न हो। OpenAI प्रमाणीकरण जोड़ने या रीफ़्रेश करने पर मौजूदा स्पष्ट
चयन सुरक्षित रहता है, जिसमें `openai/gpt-5.5` भी शामिल है, जब तक कि आप स्पष्ट रूप से
`models auth login --set-default` या `models set` का उपयोग न करें। API-कुंजी प्रमाणीकरण प्रोफ़ाइल का
उपयोग केवल तभी करें, जब किसी एजेंट मॉडल के लिए API-कुंजी प्रमाणीकरण चाहिए।
## 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 लॉन्च घोषणा](https://openai.com/index/previewing-gpt-5-6-sol/)
और [एक्सेस मार्गदर्शिका](https://help.openai.com/en/articles/20001325-a-preview-of-gpt-5-6-sol-terra-and-luna)।
प्रत्यक्ष OpenAI API-कुंजी प्रमाणीकरण के साथ, केवल `openai/gpt-5.6` आईडी Sol का उपनाम है
और नए सेटअप का डिफ़ॉल्ट है। नेटिव Codex कैटलॉग उस प्रत्यक्ष-API उपनाम को
क्लाइंट-पक्ष पर लागू नहीं करता; कार्यक्षेत्र एक्सेस के आधार पर, यह
सटीक Sol, Terra और Luna आईडी दिखा सकता है। इसलिए नया ChatGPT/Codex OAuth सेटअप
`openai/gpt-5.6-sol` का उपयोग करता है। वर्तमान खाते की जाँच इसके साथ करें:
```bash
openclaw models list --provider openai
```
API संगठन और Codex कार्यक्षेत्र एक्सेस अलग हो सकते हैं। यदि GPT-5.6
उपलब्ध नहीं है, तो GPT-5.5 को स्पष्ट रूप से चुनें:
```bash
openclaw models set openai/gpt-5.5
```
OpenClaw अपस्ट्रीम एक्सेस त्रुटि दिखाता है और GPT-5.6 चयन को चुपचाप
GPT-5.5 से प्रतिस्थापित नहीं करता।
रनटाइम नीति अनिर्धारित या `auto` होने पर योग्य, सटीक आधिकारिक HTTPS रूट बंडल किए गए Codex ऐप-सर्वर
Plugin का चयन कर सकते हैं; लिखित Completions रूट,
कस्टम एंडपॉइंट और अनुरोध-परिवहन ओवरराइड OpenClaw पर बने रहते हैं। प्लेनटेक्स्ट
आधिकारिक HTTP एंडपॉइंट अस्वीकार किए जाते हैं। स्पष्ट प्रदाता/मॉडल रनटाइम कॉन्फ़िगरेशन
प्रामाणिक बना रहता है। पुराने लेगेसी Codex मॉडल
संदर्भों, `codex-cli/*` संदर्भों या ऐसे पुराने रनटाइम सत्र पिन को सुधारने के लिए `openclaw doctor --fix` चलाएँ, जिन्हें
स्पष्ट रनटाइम कॉन्फ़िगरेशन द्वारा सेट नहीं किया गया था।
## OpenClaw फ़ीचर कवरेज
| OpenAI क्षमता | OpenClaw सतह | स्थिति |
| ------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| चैट / Responses | `openai/` मॉडल प्रदाता | हाँ |
| Codex सदस्यता मॉडल | OpenAI OAuth के साथ `openai/` | हाँ |
| पुराने Codex मॉडल संदर्भ | पुराने Codex मॉडल संदर्भ, `codex-cli/` | doctor द्वारा `openai/` में सुधारे जाते हैं |
| 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 कुंजी) |
| एम्बेडिंग | मेमोरी एम्बेडिंग प्रदाता | हाँ |
OpenAI रीयलटाइम वॉइस सार्वजनिक **OpenAI Platform Realtime
API** से होकर जाती है और इसके लिए Platform API कुंजी आवश्यक है। इसके बजाय Codex OAuth टोकन
ChatGPT Codex बैकएंड को प्रमाणित करते हैं; सार्वजनिक Realtime एंडपॉइंट के लिए वे
Platform API कुंजियों के स्थान पर उपयोग नहीं किए जा सकते।
यदि API-कुंजी प्रमाणीकरण में बिलिंग अनुपलब्ध होने की सूचना मिलती है, तो API-कुंजी
प्रमाणीकरण का उपयोग करते समय आपके रीयलटाइम क्रेडेंशियल का आधार बनने वाले संगठन के लिए
[platform.openai.com/account/billing](https://platform.openai.com/account/billing)
पर Platform क्रेडिट बढ़ाएँ। रीयलटाइम वॉइस `openclaw onboard --auth-choice openai-api-key` द्वारा बनाए गए
`openai` API-कुंजी प्रमाणीकरण प्रोफ़ाइल, Control UI Talk के लिए
`talk.realtime.providers.openai.apiKey` के माध्यम से सेट की गई Platform API कुंजी, या Voice
Call के लिए `plugins.entries.voice-call.config.realtime.providers.openai.apiKey`, अथवा `OPENAI_API_KEY` पर्यावरण चर को स्वीकार करती है।
Control UI Video Talk में OpenAI WebRTC आवश्यकता होने पर कैमरा संदर्भ प्राप्त करता है:
जब मॉडल `describe_view` को कॉल करता है, तो ब्राउज़र रीयलटाइम डेटा चैनल पर
एक सीमित JPEG भेजता है। OpenClaw, OpenAI सत्र में निरंतर कैमरा ट्रैक
संलग्न नहीं करता।
## मेमोरी एम्बेडिंग
OpenClaw, `memory_search` इंडेक्सिंग और क्वेरी एम्बेडिंग के लिए
OpenAI या OpenAI-संगत एम्बेडिंग एंडपॉइंट का उपयोग कर सकता है:
```json5
{
memory: {
search: {
provider: "openai",
model: "text-embedding-3-small",
},
},
}
```
असममित एम्बेडिंग लेबल की आवश्यकता वाले OpenAI-संगत एंडपॉइंट के लिए,
`memory.search` के अंतर्गत `queryInputType` और `documentInputType` सेट करें। OpenClaw
इन्हें प्रदाता-विशिष्ट `input_type` अनुरोध फ़ील्ड के रूप में अग्रेषित करता है: क्वेरी
एम्बेडिंग `queryInputType` का उपयोग करती हैं; इंडेक्स किए गए मेमोरी खंड और बैच इंडेक्सिंग
`documentInputType` का उपयोग करते हैं। संपूर्ण उदाहरण के लिए
[मेमोरी कॉन्फ़िगरेशन संदर्भ](/hi/reference/memory-config#provider-specific-config)
देखें।
## आरंभ करना
**इसके लिए सर्वोत्तम:** प्रत्यक्ष API पहुँच और उपयोग-आधारित बिलिंग।
[OpenAI Platform डैशबोर्ड](https://platform.openai.com/api-keys) से API कुंजी बनाएँ या कॉपी करें।
```bash
openclaw onboard --auth-choice openai-api-key
```
या कुंजी सीधे दें:
```bash
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
```
```bash
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 एंडपॉइंट | अस्वीकृत | क्रेडेंशियल नहीं भेजा जाता |
runtime unset या `auto` होने पर, केवल एक पात्र सटीक आधिकारिक HTTPS मूल
रूट ही Codex app-server हार्नेस को अंतर्निहित रूप से चुन सकता है। एजेंट मॉडल पर
API-कुंजी प्रमाणीकरण के लिए, `openai` API-कुंजी प्रमाणीकरण प्रोफ़ाइल बनाएँ और उसे
`auth.order.openai` के साथ क्रमबद्ध करें; गैर-एजेंट OpenAI API सतहों के लिए
`OPENAI_API_KEY` प्रत्यक्ष फ़ॉलबैक बना रहता है। पुराने
Codex प्रमाणीकरण-क्रम प्रविष्टियों को माइग्रेट करने के लिए `openclaw doctor --fix` चलाएँ।
### कॉन्फ़िगरेशन उदाहरण
```json5
{
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` पर सेट करें:
```json5
{
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` पर सेट करता है।
OpenClaw प्रत्यक्ष OpenAI API-कुंजी रूट पर `gpt-5.3-codex-spark`
उपलब्ध **नहीं** कराता। यह केवल Codex सदस्यता कैटलॉग प्रविष्टियों के माध्यम से
उपलब्ध होता है, जब आपका साइन-इन किया हुआ खाता इसे उपलब्ध कराता हो।
**इसके लिए सर्वोत्तम:** अलग API कुंजी के बजाय मूल Codex
app-server निष्पादन के साथ अपनी ChatGPT/Codex सदस्यता का उपयोग करना। Codex क्लाउड के लिए
ChatGPT साइन-इन आवश्यक है।
```bash
openclaw onboard --auth-choice openai
```
या OAuth सीधे चलाएँ:
```bash
openclaw models auth login --provider openai
```
हेडलेस या कॉलबैक-विरोधी सेटअप के लिए, localhost ब्राउज़र कॉलबैक के बजाय
ChatGPT डिवाइस-कोड प्रवाह से साइन इन करने हेतु `--device-code` जोड़ें:
```bash
openclaw models auth login --provider openai --device-code
```
```bash
openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol
```
इस सटीक आधिकारिक HTTPS मूल रूट के लिए किसी runtime कॉन्फ़िगरेशन की
आवश्यकता नहीं है। यह Codex app-server runtime को स्वचालित रूप से चुन सकता है, और
उस runtime के चुने जाने पर OpenClaw बंडल किए गए Codex Plugin को स्थापित या
सुधारता है।
```bash
openclaw models list --provider openai
```
Gateway चलने के बाद, मूल 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 प्रमाणीकरण |
नई सदस्यता-समर्थित सेटअप सटीक `openai/gpt-5.6-sol` का उपयोग करती है; मूल
Codex कैटलॉग सटीक Terra या Luna रेफ़ भी दिखा सकता है। यदि
खाता GPT-5.6 उपलब्ध नहीं कराता है, तो स्पष्ट रूप से `openai/gpt-5.5` चुनें। पुराने
Codex GPT रेफ़ विरासती OpenClaw रूट हैं, मूल Codex रनटाइम
पथ नहीं; किसी मौजूदा स्पष्ट GPT-5.5 चयन को अपग्रेड किए बिना उन्हें
माइग्रेट करने के लिए `openclaw doctor --fix` चलाएँ। `gpt-5.3-codex-spark` केवल
उन खातों तक सीमित रहता है जिनका Codex सदस्यता कैटलॉग इसे उपलब्ध बताता है; इसके
प्रत्यक्ष OpenAI API-कुंजी और Azure रेफ़ उपलब्ध नहीं दिखाए जाते।
नए कॉन्फ़िगरेशन में OpenAI एजेंट प्रमाणीकरण क्रम को `auth.order.openai` के अंतर्गत रखना चाहिए;
doctor पुरानी विरासती Codex प्रमाणीकरण-क्रम प्रविष्टियों को माइग्रेट करता है।
### कॉन्फ़िगरेशन उदाहरण
```json5
{
plugins: { entries: { codex: { enabled: true } } },
agents: {
defaults: {
model: { primary: "openai/gpt-5.6-sol" },
},
},
}
```
API-कुंजी बैकअप के साथ, चयनित मॉडल को `openai/*` के अंतर्गत रखें और
प्रमाणीकरण क्रम को `openai` के अंतर्गत रखें। OpenClaw पहले सदस्यता, फिर
API कुंजी आज़माता है और इस दौरान Codex हार्नेस पर बना रहता है:
```json5
{
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 सामग्री आयात नहीं करती। ब्राउज़र
OAuth (डिफ़ॉल्ट) या ऊपर दिए डिवाइस-कोड प्रवाह से साइन इन करें; OpenClaw परिणामी
क्रेडेंशियल को अपने एजेंट प्रमाणीकरण स्टोर में प्रबंधित करता है।
### Codex OAuth रूटिंग की जाँच और पुनर्प्राप्ति
```bash
openclaw models status
openclaw models auth list --provider openai
openclaw config get agents.defaults.model --json
openclaw config get models.providers.openai.agentRuntime --json
```
किसी विशिष्ट एजेंट के लिए `--agent ` जोड़ें:
```bash
openclaw models status --agent
openclaw models auth list --agent --provider openai
```
यदि किसी पुराने कॉन्फ़िगरेशन में अब भी विरासती Codex GPT रेफ़ या स्पष्ट रनटाइम
कॉन्फ़िगरेशन के बिना पुराना OpenAI रनटाइम सत्र पिन है, तो उसे सुधारें:
```bash
openclaw doctor --fix
openclaw config validate
```
यदि `models auth list --provider openai` कोई उपयोग योग्य प्रोफ़ाइल नहीं दिखाता है, तो फिर से
साइन इन करें:
```bash
openclaw models auth login --provider openai
openclaw models status --probe --probe-provider openai
```
एक ही एजेंट में एकाधिक Codex OAuth लॉगिन के लिए `--profile-id` का उपयोग करें, फिर
उन्हें प्रमाणीकरण क्रम या `/model ...@` के माध्यम से नियंत्रित करें:
```bash
openclaw models auth login --provider openai --profile-id openai:ritsuko
openclaw 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` टोकन बचते हैं। यह व्युत्पन्न संचालन बजट है, प्रदाता द्वारा
प्रकाशित कोई अलग इनपुट सीमा नहीं। आधिकारिक [मॉडल तुलना](https://developers.openai.com/api/docs/models/compare)
और [GPT-5.5 मॉडल पृष्ठ](https://developers.openai.com/api/docs/models/gpt-5.5) देखें।
निम्न उदाहरण एक Terra मॉडल के लिए उस भत्ते का वैकल्पिक चयन करता है और
OpenAI से `700000` सक्रिय टोकन पर संक्षिप्तीकरण करने को कहता है:
```json5
{
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 हार्नेस लंबा कॉन्टेक्स्ट](/hi/plugins/codex-harness#direct-api-long-context)।
GPT-5.5 या GPT-5.6 अनुरोध के `272000` इनपुट टोकन से अधिक होने पर
OpenAI अधिक लंबे-कॉन्टेक्स्ट मूल्य लागू करता है: पूरा योग्य अनुरोध
2× इनपुट और 1.5× आउटपुट दरों पर बिल किया जाता है। बड़े प्रॉम्प्ट अगले टर्न में
फिर से भेजे या संक्षिप्त किए जाते हैं, इसलिए वैकल्पिक रूप से चुने गए सत्र की
लागत डिफ़ॉल्ट से काफ़ी अधिक हो सकती है, भले ही दिखाई देने वाला उत्तर छोटा हो।
[OpenAI API मूल्य निर्धारण](https://developers.openai.com/api/docs/pricing) देखें। खाते की पहुँच,
वास्तविक सीमाओं और बिलिंग के लिए API ही प्रामाणिक रहता है।
### कैटलॉग पुनर्प्राप्ति
उपलब्ध होने पर OpenClaw `gpt-5.5` के लिए अपस्ट्रीम Codex कैटलॉग
मेटाडेटा का उपयोग करता है। यदि खाता प्रमाणित होने के बावजूद लाइव Codex खोज
`gpt-5.5` पंक्ति छोड़ देती है, तो OpenClaw उस OAuth मॉडल पंक्ति को
संश्लेषित करता है, ताकि Cron, उप-एजेंट और कॉन्फ़िगर किए गए डिफ़ॉल्ट-मॉडल रन
`Unknown model` के कारण विफल न हों।
## मूल Codex ऐप-सर्वर प्रमाणीकरण
जब कोई योग्य सटीक आधिकारिक HTTPS रूट इसे अंतर्निहित रूप से चुनता है, या जब
प्रदाता/मॉडल `agentRuntime.id: "codex"` इसे स्पष्ट रूप से चुनता है, तब मूल Codex
ऐप-सर्वर हार्नेस `openai/*` मॉडल रेफ़ का उपयोग करता है। इसका प्रमाणीकरण
फिर भी खाते पर आधारित होता है। OpenClaw इस क्रम में प्रमाणीकरण चुनता है:
1. एजेंट के लिए क्रमबद्ध OpenAI प्रमाणीकरण प्रोफ़ाइल, अधिमानतः
`auth.order.openai` के अंतर्गत। पुराने विरासती Codex प्रमाणीकरण प्रोफ़ाइल आईडी
और प्रमाणीकरण क्रम को माइग्रेट करने के लिए `openclaw doctor --fix` चलाएँ।
2. ऐप-सर्वर का मौजूदा खाता, जैसे स्थानीय Codex CLI ChatGPT
साइन-इन। डिफ़ॉल्ट पृथक एजेंट होम के लिए, OpenClaw उस मूल CLI खाते को
उसके लॉगिन RPC के माध्यम से ऐप-सर्वर में जोड़ता है; यह CLI के कॉन्फ़िगरेशन,
plugins या थ्रेड स्टोर को साझा नहीं करता।
3. केवल स्थानीय 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 को अग्रेषित नहीं किया जाता | सुरक्षित होने पर समर्थित आकार से मैप किया जाता है |
```json5
{
agents: {
defaults: {
imageGenerationModel: { primary: "openai/gpt-image-2" },
},
},
}
```
साझा टूल पैरामीटर, प्रदाता चयन और फ़ेलओवर व्यवहार के लिए
[छवि निर्माण](/hi/tools/image-generation) देखें।
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 रन के लिए भी यही सेटिंग उपलब्ध है:
```bash
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` का उपयोग करते हैं।
```json5
{
agents: {
defaults: {
videoGenerationModel: { primary: "openai/sora-2" },
},
},
}
```
साझा टूल पैरामीटर, प्रदाता चयन और फ़ेलओवर व्यवहार के लिए
[वीडियो जनरेशन](/hi/tools/video-generation) देखें।
OpenAI प्रदाता `supportsSize` घोषित करता है, लेकिन `supportsAspectRatio` या
`supportsResolution` नहीं। अनुरोध के प्रदाता तक पहुँचने से पहले OpenClaw की साझा
नॉर्मलाइज़ेशन परत अनुरोधित `aspectRatio` को निकटतम मेल खाने वाले OpenAI
`size` में बदल देती है, इसलिए आस्पेक्ट-रेशियो अनुरोध सामान्यतः फिर भी काम करते हैं।
`resolution` का कोई आकार फ़ॉलबैक नहीं है और इसे हटा दिया जाता है तथा कॉलर को
`Ignored unsupported overrides for openai/: resolution=` के रूप में दिखाया जाता है।
## 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"` | केवल मैत्रीपूर्ण शैली परत अक्षम करें |
```json5
{
agents: {
defaults: {
promptOverlays: {
gpt5: { personality: "friendly" },
},
},
},
}
```
```bash
openclaw config set agents.defaults.promptOverlays.gpt5.personality off
```
रनटाइम पर मान केस-असंवेदी होते हैं, इसलिए `"Off"` और `"off"`
दोनों मैत्रीपूर्ण शैली परत को अक्षम करते हैं।
जब साझा `agents.defaults.promptOverlays.gpt5.personality` सेटिंग अनसेट होती है, तब पुराने
`plugins.entries.openai.config.personality` को अब भी संगतता फ़ॉलबैक के रूप में पढ़ा जाता है।
## आवाज़ और वाणी
बंडल किया गया `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` जैसी अतिरिक्त कुंजियों की आवश्यकता होती है। प्रोटोटाइप कुंजियों
को अनदेखा किया जाता है।
```json5
{
tts: {
providers: {
openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },
},
},
}
```
चैट API एंडपॉइंट को प्रभावित किए बिना TTS बेस URL को ओवरराइड करने के लिए
`OPENAI_TTS_BASE_URL` सेट करें। OpenAI TTS और Realtime आवाज़, दोनों को
OpenAI Platform API कुंजी के माध्यम से कॉन्फ़िगर किया जाता है; केवल OAuth वाले
इंस्टॉल अब भी Codex-समर्थित चैट मॉडल का उपयोग कर सकते हैं, लेकिन OpenAI लाइव
टॉक-बैक का नहीं।
बंडल किया गया `openai` Plugin, OpenClaw की मीडिया-अंडरस्टैंडिंग
ट्रांसक्रिप्शन सतह के माध्यम से बैच वाणी-से-टेक्स्ट पंजीकृत करता है।
- डिफ़ॉल्ट मॉडल: `gpt-4o-transcribe`
- एंडपॉइंट: OpenAI REST `/v1/audio/transcriptions`
- इनपुट पथ: मल्टीपार्ट ऑडियो फ़ाइल अपलोड
- जहाँ भी इनबाउंड ऑडियो ट्रांसक्रिप्शन `tools.media.audio` को पढ़ता है, वहाँ उपयोग किया जाता है,
जिसमें Discord वॉइस-चैनल सेगमेंट और चैनल ऑडियो अटैचमेंट शामिल हैं
इनबाउंड ऑडियो ट्रांसक्रिप्शन के लिए OpenAI को बाध्य करने हेतु:
```json5
{
tools: {
media: {
audio: {
models: [
{
type: "provider",
provider: "openai",
model: "gpt-4o-transcribe",
},
],
},
},
},
}
```
साझा ऑडियो मीडिया कॉन्फ़िगरेशन या प्रति-कॉल ट्रांसक्रिप्शन अनुरोध द्वारा दिए जाने पर
भाषा और प्रॉम्प्ट संकेत OpenAI को अग्रेषित किए जाते हैं।
बंडल किया गया `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 कुंजी आवश्यक |
G.711 u-law (`g711_ulaw` / `audio/pcmu`) ऑडियो के साथ
`wss://api.openai.com/v1/realtime` से WebSocket कनेक्शन का उपयोग करता है। किसी
`openai` API-कुंजी प्रोफ़ाइल के लिए, Gateway WebSocket खोलने से पहले
एक अस्थायी Realtime ट्रांसक्रिप्शन क्लाइंट सीक्रेट बनाता है। यह स्ट्रीमिंग प्रदाता
Voice Call के Realtime ट्रांसक्रिप्शन पथ के लिए है; Discord वॉइस वर्तमान में छोटे
सेगमेंट रिकॉर्ड करता है और इसके बजाय बैच `tools.media.audio` ट्रांसक्रिप्शन पथ
का उपयोग करता है।
बंडल किया गया `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` पर सेट करें।
**GPT-Live (आगामी)।** OpenAI के फ़ुल-डुप्लेक्स `gpt-live-1` और
`gpt-live-1-mini` मॉडल ने जुलाई 2026 में ChatGPT वॉइस मोड का स्थान लिया; डेवलपर
API को प्रारंभिक-पहुँच संगठनों के लिए क्रमिक रूप से उपलब्ध कराया जा रहा है। OpenClaw
मॉडल परिवार को पहचानता है, लेकिन इसे अभी चलाता नहीं है: GPT-Live सत्र
केवल WebRTC पर चलते हैं, अपना टर्न-टेकिंग स्वयं संभालते हैं (VAD नहीं), और एजेंट का कार्य
एक हैंडऑफ़ इवेंट प्रोटोकॉल के माध्यम से सौंपते हैं, जिसे OpenClaw के Realtime ट्रांसपोर्ट
अभी लागू नहीं करते। `gpt-live-*` मॉडल को कॉन्फ़िगर करने पर
एजेंट पहुँच के बिना ऑडियो से चुपचाप कनेक्ट होने के बजाय WebSocket ब्रिज और Talk ब्राउज़र
दोनों सत्रों के लिए मार्गदर्शन सहित बंद अवस्था में विफलता होती है।
प्रारंभिक पहुँच के दौरान API पहुँच भी प्रत्येक OpenAI संगठन के अनुसार नियंत्रित होती है।
GPT-Live समर्थन उपलब्ध होने तक `gpt-realtime-2.1` (डिफ़ॉल्ट)
बनाए रखें।
बैकएंड OpenAI Realtime ब्रिज GA Realtime WebSocket सत्र
संरचना का उपयोग करते हैं, जो `session.temperature` स्वीकार नहीं करती। Azure OpenAI
डिप्लॉयमेंट `azureEndpoint` और `azureDeployment` के माध्यम से उपलब्ध रहते हैं और
डिप्लॉयमेंट-संगत सत्र संरचना (`temperature` सहित) बनाए रखते हैं।
द्विदिश टूल कॉलिंग और G.711 u-law ऑडियो का समर्थन करता है।
सत्र बनाते समय Realtime वॉइस चुनी जाती है। OpenAI अधिकांश
सत्र फ़ील्ड को बाद में बदलने की अनुमति देता है, लेकिन उस सत्र में मॉडल द्वारा ऑडियो उत्सर्जित
करने के बाद वॉइस नहीं बदली जा सकती। OpenClaw वर्तमान में अंतर्निहित
Realtime वॉइस आईडी को स्ट्रिंग के रूप में प्रदर्शित करता है।
Control UI Talk, Gateway द्वारा जारी अस्थायी क्लाइंट सीक्रेट और OpenAI Realtime API
के साथ सीधे ब्राउज़र WebRTC SDP एक्सचेंज वाले OpenAI ब्राउज़र Realtime सत्रों का
उपयोग करता है। Gateway उस क्लाइंट सीक्रेट को चयनित
`openai` क्रेडेंशियल से जारी करता है। कॉन्फ़िगर की गई कुंजियाँ, API-कुंजी प्रोफ़ाइल और
`OPENAI_API_KEY` को प्राथमिकता मिलती है; `openai` OAuth प्रोफ़ाइल या बाहरी
Codex लॉगिन फ़ॉलबैक है। Gateway रिले और Voice Call बैकएंड Realtime
WebSocket ब्रिज मूल OpenAI एंडपॉइंट के लिए इसी क्रेडेंशियल क्रम का उपयोग करते हैं।
मेंटेनर का लाइव सत्यापन
`OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts` के साथ उपलब्ध है;
OpenAI चरण सीक्रेट लॉग किए बिना बैकएंड WebSocket ब्रिज और ब्राउज़र
WebRTC SDP एक्सचेंज दोनों को सत्यापित करते हैं।
Google क्रेडेंशियल के बिना इन दोनों चरणों को चलाने के लिए `--openai-only` पास करें।
## Azure OpenAI एंडपॉइंट
बंडल किया गया `openai` प्रदाता बेस URL को ओवरराइड करके इमेज
जनरेशन के लिए Azure OpenAI संसाधन को लक्षित कर सकता है। इमेज-जनरेशन पथ पर, OpenClaw
`models.providers.openai.baseUrl` पर Azure होस्टनाम का पता लगाता है और
स्वचालित रूप से Azure की अनुरोध संरचना पर स्विच करता है।
Realtime वॉइस एक अलग कॉन्फ़िगरेशन पथ
(`plugins.entries.voice-call.config.realtime.providers.openai.azureEndpoint`)
का उपयोग करती है और `models.providers.openai.baseUrl` से प्रभावित नहीं होती। इसकी Azure
सेटिंग के लिए [वॉइस और स्पीच](#voice-and-speech) के अंतर्गत **Realtime
वॉइस** अकॉर्डियन देखें।
Azure OpenAI का उपयोग तब करें जब:
- आपके पास पहले से Azure OpenAI सदस्यता, कोटा या एंटरप्राइज़
अनुबंध हो
- आपको क्षेत्रीय डेटा रेज़िडेंसी या Azure द्वारा प्रदान किए जाने वाले अनुपालन नियंत्रणों की आवश्यकता हो
- आप ट्रैफ़िक को मौजूदा Azure टेनेंसी के भीतर रखना चाहते हों
### कॉन्फ़िगरेशन
बंडल किए गए `openai` प्रदाता के माध्यम से Azure इमेज जनरेशन के लिए,
`models.providers.openai.baseUrl` को अपने Azure संसाधन पर इंगित करें और `apiKey` को
Azure OpenAI कुंजी पर सेट करें (OpenAI Platform कुंजी पर नहीं):
```json5
{
models: {
providers: {
openai: {
baseUrl: "https://.openai.azure.com",
apiKey: "",
},
},
},
}
```
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 इमेज अनुरोध संरचना बनाए रखते हैं।
`openai` प्रदाता के इमेज-जनरेशन पथ के लिए Azure रूटिंग हेतु
OpenClaw 2026.4.22 या बाद का संस्करण आवश्यक है। पहले के संस्करण किसी भी कस्टम
`openai.baseUrl` को सार्वजनिक OpenAI एंडपॉइंट की तरह मानते हैं और Azure इमेज
डिप्लॉयमेंट पर विफल होते हैं।
### API संस्करण
Azure इमेज-जनरेशन पथ के लिए किसी विशिष्ट Azure प्रीव्यू या GA संस्करण को
पिन करने हेतु `AZURE_OPENAI_API_VERSION` सेट करें:
```bash
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 संस्करण द्वारा समर्थित
पैरामीटर सेट जाँचें।
Azure OpenAI मूल ट्रांसपोर्ट और संगतता व्यवहार का उपयोग करता है, लेकिन उसे
OpenClaw के छिपे हुए एट्रिब्यूशन हेडर प्राप्त नहीं होते—[उन्नत कॉन्फ़िगरेशन](#advanced-configuration) के अंतर्गत
**मूल बनाम OpenAI-संगत
रूट** अकॉर्डियन देखें।
Azure पर चैट या Responses ट्रैफ़िक (इमेज जनरेशन से परे) के लिए,
ऑनबोर्डिंग प्रवाह या समर्पित Azure प्रदाता कॉन्फ़िग का उपयोग करें; केवल `openai.baseUrl`
Azure API/प्रमाणीकरण संरचना को नहीं अपनाता। एक अलग
`azure-openai-responses/*` प्रदाता मौजूद है; नीचे Server-side compaction
अकॉर्डियन देखें।
## उन्नत कॉन्फ़िगरेशन
नीचे दिए गए प्रति-मॉडल `params` उदाहरण OpenClaw के एम्बेडेड प्रदाता
अनुरोध को आकार देते हैं। इन्हें कॉन्फ़िगर करना स्वयं निर्धारित अनुरोध व्यवहार है, इसलिए अन्यथा पात्र
`auto` रूट Codex को अंतर्निहित रूप से चुनने के बजाय OpenClaw पर ही रहता है। मूल
Codex ऐप-सर्वर हार्नेस अपने ट्रांसपोर्ट और अनुरोध सेटिंग का स्वामी है; प्रभावी रूट को
Codex-संगत घोषित न किए जाने पर स्पष्ट
`agentRuntime.id: "codex"` बंद अवस्था में विफल होता है।
OpenClaw, `openai/*` के लिए SSE फ़ॉलबैक (`"auto"`) के साथ WebSocket-प्रथम का उपयोग करता है।
`"auto"` मोड में, OpenClaw:
- SSE पर फ़ॉलबैक करने से पहले एक शुरुआती WebSocket विफलता पर दोबारा प्रयास करता है
- विफलता के बाद, WebSocket को 60 सेकंड के लिए अवनत चिह्नित करता है और कूल-डाउन
के दौरान SSE का उपयोग करता है
- पुनः प्रयास और पुनः कनेक्शन के लिए स्थिर सत्र तथा टर्न पहचान हेडर
संलग्न करता है
- ट्रांसपोर्ट वेरिएंट में उपयोग काउंटर (`input_tokens` / `prompt_tokens`) को
सामान्यीकृत करता है
| मान | व्यवहार |
| ---------------------- | ------------------------------------ |
| `"auto"` (डिफ़ॉल्ट) | पहले WebSocket, SSE फ़ॉलबैक |
| `"sse"` | केवल SSE बाध्य करें |
| `"websocket"` | केवल WebSocket बाध्य करें |
```json5
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: { transport: "auto" },
},
},
},
},
}
```
संबंधित OpenAI दस्तावेज़:
- [WebSocket के साथ Realtime API](https://platform.openai.com/docs/guides/realtime-websocket)
- [स्ट्रीमिंग API प्रतिक्रियाएँ (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
OpenClaw, `openai/*` के लिए एक साझा तेज़-मोड टॉगल उपलब्ध कराता है:
- **चैट/UI:** `/fast status|auto|on|off`
- **कॉन्फ़िग:** `agents.defaults.models["/"].params.fastMode`
सक्षम होने पर, OpenClaw तेज़ मोड को OpenAI प्राथमिकता प्रोसेसिंग
(`service_tier = "priority"`) से मैप करता है। मौजूदा `service_tier` मान
सुरक्षित रखे जाते हैं, और तेज़ मोड `reasoning` या
`text.verbosity` को दोबारा नहीं लिखता। `fastMode: "auto"` स्वतः कटऑफ़ तक नए मॉडल कॉल
तेज़ मोड में शुरू करता है, फिर बाद के पुनः प्रयास, फ़ॉलबैक, टूल-परिणाम या
निरंतरता कॉल तेज़ मोड के बिना शुरू करता है। कटऑफ़ का डिफ़ॉल्ट 60 सेकंड है;
इसे बदलने के लिए सक्रिय मॉडल पर `params.fastAutoOnSeconds` सेट करें।
```json5
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },
},
},
},
}
```
सत्र ओवरराइड को कॉन्फ़िग पर प्राथमिकता मिलती है। Sessions UI में सत्र ओवरराइड साफ़ करने पर
सत्र कॉन्फ़िगर किए गए डिफ़ॉल्ट पर लौट जाता है।
OpenAI का API `service_tier` के माध्यम से प्राथमिकता प्रोसेसिंग उपलब्ध कराता है। इसे OpenClaw में
प्रत्येक मॉडल के लिए सेट करें:
```json5
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": { params: { serviceTier: "priority" } },
},
},
},
}
```
समर्थित मान: `auto`, `default`, `flex`, `priority`।
`serviceTier` केवल मूल OpenAI एंडपॉइंट
(`api.openai.com`) और मूल Codex एंडपॉइंट (`chatgpt.com/backend-api`) को अग्रेषित किया जाता है।
यदि आप किसी भी प्रदाता को प्रॉक्सी के माध्यम से रूट करते हैं, तो OpenClaw
`service_tier` को अपरिवर्तित छोड़ देता है।
प्रत्यक्ष 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 जैसे संगत एंडपॉइंट के लिए उपयोगी:
```json5
{
agents: {
defaults: {
models: {
"azure-openai-responses/gpt-5.5": {
params: { responsesServerCompaction: true },
},
},
},
},
}
```
```json5
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: {
responsesServerCompaction: true,
responsesCompactThreshold: 120000,
},
},
},
},
},
}
```
```json5
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: { responsesServerCompaction: false },
},
},
},
},
}
```
`responsesServerCompaction` केवल `context_management` के अंतःक्षेपण को नियंत्रित करता है।
प्रत्यक्ष OpenAI Responses मॉडल तब भी `store: true` को अनिवार्य करते हैं, जब तक संगतता
`supportsStore: false` सेट न करे।
OpenClaw के एम्बेडेड रनटाइम के माध्यम से चलने वाले `openai` प्रदाता के GPT-5-परिवार मॉडल के लिए,
OpenClaw पहले से ही `strict-agentic` नामक अधिक सख्त निष्पादन अनुबंध को
डिफ़ॉल्ट रूप से उपयोग करता है। जब भी समाधान किया गया प्रदाता
`openai` हो और मॉडल आईडी GPT-5 परिवार से मेल खाती हो, यह स्वतः सक्रिय हो जाता है, जब तक कॉन्फ़िगरेशन
स्पष्ट रूप से इससे बाहर निकलने का विकल्प न चुने:
```json5
{
agents: {
defaults: {
embeddedAgent: { executionContract: "default" },
},
},
}
```
`"strict-agentic"` को स्पष्ट रूप से सेट करने का समर्थित लेन पर कोई प्रभाव नहीं पड़ता (यह
पहले से ही डिफ़ॉल्ट है) और असमर्थित प्रदाता/मॉडल युग्मों पर यह निष्क्रिय रहता है।
`strict-agentic` सक्रिय होने पर, OpenClaw:
- पर्याप्त कार्य के लिए `update_plan` को स्वतः सक्षम करता है
- संरचनात्मक रूप से खाली या केवल तर्क वाले टर्न को दृश्यमान-उत्तर
निरंतरता के साथ पुनः प्रयास करता है
- चयनित हार्नेस द्वारा उपलब्ध कराए जाने पर स्पष्ट हार्नेस योजना इवेंट का
उपयोग करता है
OpenClaw यह तय करने के लिए सहायक के गद्य को वर्गीकृत नहीं करता कि कोई टर्न
योजना, प्रगति अपडेट या अंतिम उत्तर है।
यह अनुबंध पूरी तरह OpenClaw के एम्बेडेड एजेंट रनर में स्थित है। यह
मूल Codex ऐप-सर्वर हार्नेस पर लागू नहीं होता, जो अपने टर्न और योजना
व्यवहार का स्वयं प्रबंधन करता है; मूल Codex रन के लिए निष्पादन-अनुबंध
सेटिंग की तुलना में हार्नेस का चयन अधिक महत्वपूर्ण है।
OpenClaw प्रत्यक्ष OpenAI, Codex और Azure OpenAI एंडपॉइंट को
सामान्य OpenAI-संगत `/v1` प्रॉक्सी से अलग तरीके से संभालता है:
**मूल रूट** (`openai/*`, Azure OpenAI):
- `reasoning: { effort: "none" }` केवल उन मॉडलों के लिए रखता है जो
OpenAI `none` प्रयास का समर्थन करते हैं
- उन मॉडलों या प्रॉक्सी के लिए अक्षम तर्क को छोड़ देता है जो
`reasoning.effort: "none"` को अस्वीकार करते हैं
- टूल स्कीमा को डिफ़ॉल्ट रूप से सख्त मोड में रखता है
- छिपे हुए एट्रिब्यूशन हेडर केवल सत्यापित मूल होस्ट पर संलग्न करता है (Azure
OpenAI को ये हेडर नहीं मिलते, भले ही वह एक मूल रूट हो)
- केवल-OpenAI अनुरोध आकार-निर्धारण (`service_tier`, `store`,
तर्क-संगतता, प्रॉम्प्ट-कैश संकेत) बनाए रखता है
**प्रॉक्सी/संगत रूट:**
- अधिक शिथिल संगतता व्यवहार का उपयोग करते हैं
- गैर-मूल `openai-completions` पेलोड से Completions `store` हटाते हैं
- OpenAI-संगत Completions प्रॉक्सी के लिए उन्नत `params.extra_body`/`params.extraBody` पास-थ्रू JSON
स्वीकार करते हैं
- vLLM जैसे OpenAI-संगत Completions
प्रॉक्सी के लिए `params.chat_template_kwargs` स्वीकार करते हैं
- सख्त टूल स्कीमा या केवल-मूल हेडर को अनिवार्य नहीं करते
## संबंधित
प्रदाताओं, मॉडल संदर्भों और फ़ेलओवर व्यवहार का चयन।
साझा इमेज टूल पैरामीटर और प्रदाता चयन।
साझा वीडियो टूल पैरामीटर और प्रदाता चयन।
प्रमाणीकरण विवरण और क्रेडेंशियल के पुनः उपयोग के नियम।