OpenAI

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

OpenClaw कैननिकल OpenAI मॉडल रूट के रूप में openai/* का उपयोग करता है। OpenAI मॉडलों पर एम्बेडेड एजेंट टर्न डिफ़ॉल्ट रूप से नेटिव Codex ऐप-सर्वर रनटाइम के माध्यम से चलते हैं; इमेज, एम्बेडिंग, स्पीच और रियलटाइम जैसे गैर-एजेंट OpenAI सतहों के लिए प्रत्यक्ष OpenAI API-key प्रमाणीकरण उपलब्ध रहता है।

• एजेंट मॉडल - Codex रनटाइम के माध्यम से openai/* मॉडल; ChatGPT/Codex सब्सक्रिप्शन उपयोग के लिए Codex प्रमाणीकरण से साइन इन करें, या जब आप जानबूझकर API-key प्रमाणीकरण चाहते हों, तब Codex-संगत OpenAI API-key बैकअप कॉन्फ़िगर करें।
• गैर-एजेंट OpenAI API - OPENAI_API_KEY या OpenAI API-key ऑनबोर्डिंग के माध्यम से उपयोग-आधारित बिलिंग के साथ प्रत्यक्ष OpenAI Platform पहुंच।
• लेगेसी कॉन्फ़िग - लेगेसी Codex मॉडल संदर्भों को openclaw doctor --fix द्वारा openai/* और Codex रनटाइम में सुधारा जाता है।

OpenAI स्पष्ट रूप से OpenClaw जैसे बाहरी टूल और वर्कफ़्लो में सब्सक्रिप्शन OAuth उपयोग का समर्थन करता है।

Provider, मॉडल, रनटाइम और चैनल अलग-अलग परतें हैं। यदि ये लेबल आपस में मिल रहे हैं, तो कॉन्फ़िग बदलने से पहले एजेंट रनटाइम पढ़ें।

तुरंत चयन

नामकरण मैप

नाम समान हैं, लेकिन परस्पर बदलने योग्य नहीं हैं:

इसका अर्थ है कि कोई कॉन्फ़िग जानबूझकर openai/* मॉडल संदर्भ रख सकता है, जबकि प्रमाणीकरण प्रोफ़ाइल API-key या ChatGPT/Codex OAuth क्रेडेंशियल में से किसी पर इंगित कर सकती हैं। कॉन्फ़िग के लिए auth.order.openai का उपयोग करें; openclaw doctor --fix लेगेसी Codex मॉडल संदर्भों, लेगेसी Codex प्रमाणीकरण प्रोफ़ाइल id और लेगेसी Codex प्रमाणीकरण क्रम को कैननिकल OpenAI रूट में फिर से लिखता है।

OpenClaw सुविधा कवरेज

मेमोरी एम्बेडिंग

OpenClaw memory_search इंडेक्सिंग और क्वेरी एम्बेडिंग के लिए OpenAI या OpenAI-संगत एम्बेडिंग एंडपॉइंट का उपयोग कर सकता है:

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

ऐसे OpenAI-संगत एंडपॉइंट जिनमें असममित एम्बेडिंग लेबल चाहिए, उनके लिए memorySearch के अंतर्गत queryInputType और documentInputType सेट करें। OpenClaw इन्हें provider-विशिष्ट input_type अनुरोध फ़ील्ड के रूप में आगे भेजता है: क्वेरी एम्बेडिंग queryInputType का उपयोग करती हैं; इंडेक्स किए गए मेमोरी खंड और बैच इंडेक्सिंग documentInputType का उपयोग करते हैं। पूरे उदाहरण के लिए मेमोरी कॉन्फ़िगरेशन संदर्भ देखें।

शुरू करना

अपनी पसंदीदा प्रमाणीकरण विधि चुनें और सेटअप चरणों का पालन करें।

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

Native Codex ऐप-सर्वर auth

Native Codex ऐप-सर्वर हार्नेस openai/* model refs plus omitted runtime config या provider/model agentRuntime.id: "codex" उपयोग करता है, लेकिन इसका auth अब भी account-based है। OpenClaw इस क्रम में auth चुनता है:

1. Agent के लिए ordered OpenAI auth profiles, बेहतर है auth.order.openai के अंतर्गत। पुराने legacy Codex auth profile ids और legacy Codex auth order migrate करने के लिए openclaw doctor --fix चलाएं।
2. ऐप-सर्वर का मौजूदा account, जैसे local Codex CLI ChatGPT sign-in।
3. केवल local stdio ऐप-सर्वर launches के लिए, CODEX_API_KEY, फिर OPENAI_API_KEY, जब ऐप-सर्वर कोई account report नहीं करता और फिर भी OpenAI auth मांगता है।

इसका मतलब है कि local ChatGPT/Codex subscription sign-in को सिर्फ इसलिए replace नहीं किया जाता क्योंकि gateway process के पास direct OpenAI models या embeddings के लिए OPENAI_API_KEY भी है। Env API-की fallback केवल local stdio no-account path है; इसे WebSocket ऐप-सर्वर connections को नहीं भेजा जाता। जब subscription-style Codex profile चुनी जाती है, OpenClaw spawned stdio ऐप-सर्वर child से CODEX_API_KEY और OPENAI_API_KEY भी बाहर रखता है और चुने गए credentials को ऐप-सर्वर login RPC के माध्यम से भेजता है। जब वह subscription profile किसी Codex usage limit से blocked होती है, OpenClaw selected model बदले बिना या Codex harness से बाहर निकले बिना अगले ordered openai:* API-की profile पर rotate कर सकता है। Subscription reset time बीत जाने के बाद, subscription profile फिर से eligible हो जाती है।

Image generation

Bundled openai plugin image_generate tool के माध्यम से image generation register करता है। यह उसी openai/gpt-image-2 model ref के माध्यम से OpenAI API-की image generation और Codex OAuth image generation दोनों को support करता है।

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

gpt-image-2, OpenAI text-to-image generation और image editing दोनों के लिए default है। gpt-image-1.5, gpt-image-1, और gpt-image-1-mini explicit model overrides के रूप में usable रहते हैं। Transparent-background PNG/WebP output के लिए openai/gpt-image-1.5 उपयोग करें; मौजूदा gpt-image-2 API background: "transparent" reject करता है।

पारदर्शी-पृष्ठभूमि अनुरोध के लिए, एजेंटों को 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 रेफ़ रखें। जब कोई 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/प्रदाता रूट जैसे लेगेसी प्री-रिपेयर रेफ़ (लेगेसी Codex GPT-5.5 रेफ़), openrouter/openai/gpt-5.5, opencode/gpt-5.5, और अन्य संगत GPT-5 रेफ़ को वही ओवरले मिलता है। पुराने GPT-4.x मॉडल को नहीं।

बंडल किए गए नेटिव Codex हार्नेस को Codex ऐप-सर्वर डेवलपर निर्देशों के ज़रिए यह 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 base URL override करके image generation के लिए Azure OpenAI resource को target कर सकता है। image-generation path पर, OpenClaw models.providers.openai.baseUrl पर Azure hostnames detect करता है और अपने-आप Azure के request shape पर switch करता है।

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

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

Configuration

बंडल किए गए openai provider के माध्यम से Azure image generation के लिए, models.providers.openai.baseUrl को अपने Azure resource पर point करें और apiKey को Azure OpenAI key पर set करें (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 का उपयोग करता है। Per-call timeoutMs values अब भी इस default को override करती हैं।

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

API version

Azure image-generation path के लिए कोई specific Azure preview या GA version pin करने हेतु AZURE_OPENAI_API_VERSION set करें:

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

Variable unset होने पर default 2024-12-01-preview है।

Model names are deployment names

Azure OpenAI models को deployments से bind करता है। बंडल किए गए openai provider के माध्यम से route की गई Azure image-generation requests के लिए, OpenClaw में model field वह Azure deployment name होना चाहिए जिसे आपने Azure portal में configured किया है, 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 के माध्यम से route की गई image-generation calls पर लागू होता है।

Regional availability

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

Parameter differences

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

Advanced configuration

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

संबंधित