OpenAI

OpenAI GPT मॉडलों के लिए डेवलपर API प्रदान करता है, और Codex OpenAI के Codex क्लाइंट्स के माध्यम से ChatGPT-प्लान कोडिंग एजेंट के रूप में भी उपलब्ध है। OpenClaw दोनों auth आकारों के लिए एक provider id, openai, का उपयोग करता है।

OpenClaw कैननिकल OpenAI मॉडल रूट के रूप में openai/* का उपयोग करता है। OpenAI मॉडलों पर एम्बेडेड एजेंट turns डिफ़ॉल्ट रूप से native Codex app-server runtime के माध्यम से चलते हैं; direct OpenAI API-key auth images, embeddings, speech, और realtime जैसी non-agent OpenAI surfaces के लिए उपलब्ध रहता है।

• एजेंट मॉडल - Codex runtime के माध्यम से openai/* मॉडल; ChatGPT/Codex subscription उपयोग के लिए Codex auth से साइन इन करें, या जब आप जानबूझकर API-key auth चाहते हों तब Codex-compatible OpenAI API-key backup कॉन्फ़िगर करें।
• Non-agent OpenAI APIs - OPENAI_API_KEY या OpenAI API-key onboarding के माध्यम से usage-based billing के साथ direct OpenAI Platform access।
• Legacy config - legacy Codex model refs को openclaw doctor --fix द्वारा openai/* और Codex runtime में सुधारा जाता है।

OpenAI OpenClaw जैसे external tools और workflows में subscription OAuth उपयोग को स्पष्ट रूप से support करता है।

Provider, model, runtime, और channel अलग-अलग layers हैं। अगर ये labels आपस में मिल रहे हैं, तो config बदलने से पहले Agent runtimes पढ़ें।

त्वरित चयन

नामकरण मैप

नाम समान हैं लेकिन interchangeable नहीं हैं:

इसका अर्थ है कि कोई config जानबूझकर openai/* model refs रख सकता है, जबकि auth profiles API-key या ChatGPT/Codex OAuth credentials में से किसी एक की ओर point करते हैं। config के लिए auth.order.openai का उपयोग करें; openclaw doctor --fix legacy legacy Codex model refs, legacy Codex auth profile ids, और legacy Codex auth order को canonical OpenAI route में rewrite करता है।

GPT-5.6 limited preview

OpenClaw तीन public GPT-5.6 model ids को पहचानता है:

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

वर्तमान Codex app-server catalog में तीनों max reasoning expose करते हैं। OpenAI launch announcement Sol को flagship tier, Terra को balanced tier, और Luna को fast, lower-cost tier के रूप में describe करता है। देखें GPT-5.6 launch announcement और preview access guide।

preview के दौरान access allowlisted है और API तथा Codex के लिए अलग-अलग grant किया जा सकता है। केवल paid ChatGPT plan access grant नहीं करता। OpenClaw openai/gpt-5.5 को डिफ़ॉल्ट रखता है; access के बिना GPT-5.6 ref चुनने पर silent fallback के बजाय upstream access error return होता है।

OpenClaw feature coverage

Memory embeddings

OpenClaw memory_search indexing और query embeddings के लिए OpenAI, या OpenAI-compatible embedding endpoint का उपयोग कर सकता है:

{  agents: {    defaults: {      memorySearch: {        provider: "openai",        model: "text-embedding-3-small",      },    },  },}

OpenAI-compatible endpoints के लिए जिन्हें asymmetric embedding labels की आवश्यकता होती है, memorySearch के अंतर्गत queryInputType और documentInputType set करें। OpenClaw इन्हें provider-specific input_type request fields के रूप में forward करता है: query embeddings queryInputType का उपयोग करते हैं; indexed memory chunks और batch indexing documentInputType का उपयोग करते हैं। पूरे example के लिए Memory configuration reference देखें।

शुरू करना

अपनी पसंदीदा auth method चुनें और setup steps follow करें।

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/chat-latest" } } },}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.5

openclaw models list --provider openai

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  auth: {    order: {      openai: [        "openai:user@example.com",        "openai:api-key-backup",      ],    },  },}

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

openclaw doctor --fixopenclaw config validate

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

नेटिव Codex app-server ऑथ

नेटिव Codex app-server हार्नेस openai/* मॉडल रेफ और छोड़े गए रनटाइम कॉन्फ़िग या provider/model agentRuntime.id: "codex" का उपयोग करता है, लेकिन इसका ऑथ अब भी account-based है। OpenClaw इस क्रम में ऑथ चुनता है:

1. एजेंट के लिए क्रमबद्ध OpenAI ऑथ प्रोफ़ाइल, प्राथमिकता से auth.order.openai के अंतर्गत। पुराने लेगेसी Codex ऑथ प्रोफ़ाइल ids और लेगेसी Codex ऑथ क्रम को माइग्रेट करने के लिए openclaw doctor --fix चलाएं।
2. app-server का मौजूदा खाता, जैसे स्थानीय Codex CLI ChatGPT साइन-इन।
3. केवल स्थानीय stdio app-server लॉन्च के लिए, CODEX_API_KEY, फिर OPENAI_API_KEY, जब app-server कोई खाता रिपोर्ट नहीं करता और अब भी OpenAI ऑथ मांगता है।

इसका अर्थ है कि स्थानीय ChatGPT/Codex सदस्यता साइन-इन केवल इसलिए बदला नहीं जाता क्योंकि Gateway प्रोसेस के पास सीधे OpenAI मॉडल या embeddings के लिए OPENAI_API_KEY भी है। Env API-key फ़ॉलबैक केवल स्थानीय stdio no-account पाथ है; इसे WebSocket app-server कनेक्शनों को नहीं भेजा जाता। जब सदस्यता-शैली Codex प्रोफ़ाइल चुनी जाती है, OpenClaw spawned stdio app-server child से CODEX_API_KEY और OPENAI_API_KEY को भी बाहर रखता है और चुने गए क्रेडेंशियल्स app-server login RPC के माध्यम से भेजता है। जब वह सदस्यता प्रोफ़ाइल Codex उपयोग सीमा से ब्लॉक होती है, OpenClaw चुने गए मॉडल को बदले बिना या Codex हार्नेस से बाहर निकले बिना अगले क्रमबद्ध openai:* API-key प्रोफ़ाइल पर रोटेट कर सकता है। सदस्यता रीसेट समय बीत जाने पर, सदस्यता प्रोफ़ाइल फिर से पात्र हो जाती है।

इमेज जनरेशन

बंडल किया गया openai Plugin image_generate टूल के माध्यम से इमेज जनरेशन रजिस्टर करता है। यह OpenAI API-key इमेज जनरेशन और Codex OAuth इमेज जनरेशन, दोनों को एक ही openai/gpt-image-2 मॉडल रेफ के माध्यम से सपोर्ट करता है।

{  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

gpt-image-2 OpenAI टेक्स्ट-से-इमेज जनरेशन और इमेज संपादन दोनों के लिए डिफ़ॉल्ट है। gpt-image-1.5, gpt-image-1, और gpt-image-1-mini स्पष्ट मॉडल ओवरराइड के रूप में उपयोग योग्य बने रहते हैं। पारदर्शी-पृष्ठभूमि PNG/WebP आउटपुट के लिए openai/gpt-image-1.5 का उपयोग करें; मौजूदा gpt-image-2 API background: "transparent" को अस्वीकार करता है।

पारदर्शी-पृष्ठभूमि अनुरोध के लिए, एजेंटों को image_generate को model: "openai/gpt-image-1.5", outputFormat: "png" या "webp", और background: "transparent" के साथ कॉल करना चाहिए; पुराना openai.background प्रदाता विकल्प अभी भी स्वीकार किया जाता है। OpenClaw सार्वजनिक OpenAI और OpenAI Codex OAuth मार्गों की भी सुरक्षा करता है, डिफ़ॉल्ट openai/gpt-image-2 पारदर्शी अनुरोधों को gpt-image-1.5 में फिर से लिखकर; Azure और कस्टम OpenAI-संगत एंडपॉइंट अपने कॉन्फ़िगर किए गए डिप्लॉयमेंट/मॉडल नाम रखते हैं।

हेडलेस CLI रन के लिए वही सेटिंग उपलब्ध है:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "A simple red circle sticker on a transparent background" \  --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 ref रखें। जब कोई 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="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

पारदर्शी PNG जनरेट करें:

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

संपादित करें:

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

वीडियो जनरेशन

बंडल किया गया openai Plugin video_generate टूल के माध्यम से वीडियो जनरेशन पंजीकृत करता है।

OpenAI इमेज-से-वीडियो अनुरोध इमेज input_reference के साथ POST /v1/videos का उपयोग करते हैं। एकल-वीडियो संपादन video फ़ील्ड में अपलोड किए गए वीडियो के साथ POST /v1/videos/edits का उपयोग करते हैं।

{  agents: {    defaults: {      videoGenerationModel: { primary: "openai/sora-2" },    },  },}

GPT-5 प्रॉम्प्ट योगदान

OpenClaw, OpenClaw-असेंबल किए गए प्रॉम्प्ट सरफ़ेस पर GPT-5-फ़ैमिली रन के लिए साझा GPT-5 प्रॉम्प्ट योगदान जोड़ता है। यह मॉडल id के आधार पर लागू होता है, इसलिए OpenClaw/प्रदाता मार्ग जैसे लेगेसी प्री-रिपेयर refs (लेगेसी Codex GPT-5.5 ref), openrouter/openai/gpt-5.5, opencode/gpt-5.5, और अन्य संगत GPT-5 refs को वही ओवरले मिलता है। पुराने GPT-4.x मॉडल नहीं मिलते।

बंडल किए गए नेटिव Codex हार्नेस को Codex app-server डेवलपर निर्देशों के माध्यम से यह OpenClaw GPT-5 ओवरले नहीं मिलता। नेटिव Codex, Codex-स्वामित्व वाले बेस, मॉडल, और प्रोजेक्ट-डॉक व्यवहार को रखता है, जबकि OpenClaw नेटिव थ्रेड के लिए Codex की बिल्ट-इन पर्सनैलिटी को अक्षम करता है ताकि एजेंट वर्कस्पेस पर्सनैलिटी फ़ाइलें प्राधिकृत रहें। OpenClaw केवल रनटाइम संदर्भ जैसे चैनल डिलीवरी, OpenClaw डायनेमिक टूल, ACP डेलीगेशन, वर्कस्पेस संदर्भ, और OpenClaw Skills का योगदान करता है।

GPT-5 योगदान, मेल खाते OpenClaw-असेंबल किए गए प्रॉम्प्ट पर व्यक्तित्व स्थायित्व, निष्पादन सुरक्षा, टूल अनुशासन, आउटपुट आकार, पूर्णता जांच, और सत्यापन के लिए टैग किया हुआ व्यवहार अनुबंध जोड़ता है। चैनल-विशिष्ट उत्तर और साइलेंट-मैसेज व्यवहार साझा OpenClaw सिस्टम प्रॉम्प्ट और आउटबाउंड डिलीवरी नीति में रहता है। मित्रवत इंटरैक्शन-स्टाइल लेयर अलग और कॉन्फ़िगर करने योग्य है।

{  agents: {    defaults: {      promptOverlays: {        gpt5: { personality: "friendly" },      },    },  },}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

वॉइस और स्पीच

{  messages: {    tts: {      providers: {        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },      },    },  },}

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "openai",            model: "gpt-4o-transcribe",          },        ],      },    },  },}

Azure OpenAI endpoints

बंडल किया गया openai provider बेस URL को override करके image generation के लिए Azure OpenAI resource को target कर सकता है। image-generation पथ पर, OpenClaw models.providers.openai.baseUrl पर Azure hostnames का पता लगाता है और स्वचालित रूप से Azure के request shape पर स्विच करता है।

Azure OpenAI का उपयोग तब करें जब:

• आपके पास पहले से Azure OpenAI subscription, quota, या enterprise agreement हो
• आपको Azure द्वारा दिए जाने वाले regional data residency या compliance controls चाहिए
• आप traffic को मौजूदा Azure tenancy के भीतर रखना चाहते हों

कॉन्फ़िगरेशन

बंडल किए गए openai provider के माध्यम से Azure image generation के लिए, models.providers.openai.baseUrl को अपने Azure resource पर point करें और apiKey को Azure OpenAI key पर सेट करें (OpenAI Platform key नहीं):

{  models: {    providers: {      openai: {        baseUrl: "https://<your-resource>.openai.azure.com",        apiKey: "<azure-openai-api-key>",      },    },  },}

OpenClaw Azure image-generation route के लिए इन Azure host suffixes को पहचानता है:

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

पहचाने गए Azure host पर image-generation requests के लिए, OpenClaw:

• Authorization: Bearer के बजाय api-key header भेजता है
• deployment-scoped paths (/openai/deployments/{deployment}/...) का उपयोग करता है
• प्रत्येक request में ?api-version=... जोड़ता है
• Azure image-generation calls के लिए 600s default request timeout का उपयोग करता है। प्रति-call timeoutMs values अब भी इस default को override करती हैं।

अन्य base URLs (public OpenAI, OpenAI-compatible proxies) standard OpenAI image request shape बनाए रखते हैं।

API version

Azure image-generation पथ के लिए किसी specific Azure preview या GA version को pin करने के लिए AZURE_OPENAI_API_VERSION सेट करें:

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

जब variable unset हो, default 2024-12-01-preview है।

मॉडल नाम deployment names होते हैं

Azure OpenAI models को deployments से bind करता है। बंडल किए गए openai provider के माध्यम से routed Azure image-generation requests के लिए, OpenClaw में model field Azure deployment name होना चाहिए जिसे आपने Azure portal में कॉन्फ़िगर किया है, public OpenAI model id नहीं।

यदि आप gpt-image-2-prod नाम का deployment बनाते हैं जो gpt-image-2 serve करता है:

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

यही deployment-name rule बंडल किए गए openai provider के माध्यम से routed image-generation calls पर लागू होता है।

क्षेत्रीय उपलब्धता

Azure image generation अभी केवल regions के subset में उपलब्ध है (उदाहरण के लिए eastus2, swedencentral, polandcentral, westus3, uaenorth)। deployment बनाने से पहले Microsoft की वर्तमान region list देखें, और पुष्टि करें कि specific model आपके region में उपलब्ध है।

पैरामीटर अंतर

Azure OpenAI और public OpenAI हमेशा वही image parameters स्वीकार नहीं करते। Azure उन options को reject कर सकता है जिनकी public OpenAI अनुमति देता है (उदाहरण के लिए gpt-image-2 पर कुछ background values) या उन्हें केवल specific model versions पर expose कर सकता है। ये अंतर Azure और underlying model से आते हैं, OpenClaw से नहीं। यदि Azure request validation error के साथ fail होती है, तो Azure portal में अपने specific deployment और API version द्वारा supported parameter set देखें।

उन्नत कॉन्फ़िगरेशन

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { serviceTier: "priority" } },      },    },  },}

{  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 },        },      },    },  },}

{  agents: {    defaults: {      embeddedAgent: { executionContract: "strict-agentic" },    },  },}

संबंधित