xAI

OpenClaw, Grok मॉडल के लिए एक बंडल किया हुआ xai प्रदाता Plugin उपलब्ध कराता है। अनुशंसित तरीका पात्र SuperGrok या X Premium सदस्यता के साथ Grok OAuth का उपयोग करना है। Gateway, कॉन्फ़िगरेशन, रूटिंग और टूल स्थानीय रहते हैं; केवल Grok अनुरोध xAI के API पर जाते हैं। OAuth के लिए xAI API कुंजी या Grok Build ऐप की आवश्यकता नहीं होती। xAI सहमति स्क्रीन पर फिर भी Grok Build दिखा सकता है, क्योंकि OpenClaw, xAI के साझा OAuth क्लाइंट का उपयोग करता है।

सेटअप

नया इंस्टॉल

डेमन इंस्टॉल के साथ ऑनबोर्डिंग चलाएँ, फिर मॉडल/प्रमाणीकरण चरण में xAI/Grok OAuth चुनें:

openclaw onboard --install-daemon

VPS पर या SSH के माध्यम से, सीधे xAI OAuth चुनें; यह डिवाइस-कोड सत्यापन का उपयोग करता है और इसे localhost कॉलबैक की आवश्यकता नहीं होती:

openclaw onboard --install-daemon --auth-choice xai-oauth

मौजूदा इंस्टॉल

केवल xAI में साइन इन करें; सिर्फ़ Grok कनेक्ट करने के लिए पूरी ऑनबोर्डिंग दोबारा न चलाएँ:

openclaw models auth login --provider xai --method oauth

Grok को डिफ़ॉल्ट मॉडल के रूप में अलग से लागू करें:

openclaw models set xai/grok-4.3

पूरी ऑनबोर्डिंग केवल तभी दोबारा चलाएँ, जब आप जानबूझकर Gateway, डेमन, चैनल, वर्कस्पेस या अन्य सेटअप विकल्प बदलना चाहते हों।

API-कुंजी का तरीका

API-कुंजी सेटअप अब भी xAI Console कुंजियों और उन मीडिया सतहों के लिए काम करता है, जिन्हें कुंजी-समर्थित प्रदाता कॉन्फ़िगरेशन की आवश्यकता होती है:

openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...

मॉडल चुनें

{
  agents: { defaults: { model: { primary: "xai/grok-4.3" } } },
}

OpenClaw, बंडल किए हुए xAI ट्रांसपोर्ट के रूप में xAI Responses API का उपयोग करता है। openclaw models auth login --provider xai --method oauth या --method api-key से प्राप्त वही क्रेडेंशियल web_search (प्रदाता आईडी grok), x_search, code_execution, वाक्/ट्रांसक्रिप्शन और xAI छवि/वीडियो जनरेशन को भी संचालित करता है। यदि आप plugins.entries.xai.config.webSearch.apiKey के अंतर्गत xAI कुंजी संग्रहीत करते हैं, तो बंडल किया हुआ xAI मॉडल प्रदाता उसे फ़ॉलबैक के रूप में भी पुनः उपयोग करता है।

OAuth समस्या निवारण

SSH, Docker, VPS या अन्य रिमोट सेटअप के लिए, openclaw models auth login --provider xai --method oauth का उपयोग करें; यह localhost कॉलबैक के बजाय डिवाइस-कोड सत्यापन का उपयोग करता है।
यदि साइन-इन सफल हो जाता है, लेकिन Grok डिफ़ॉल्ट मॉडल नहीं है, तो openclaw models set xai/grok-4.3 चलाएँ।
सहेजी गई xAI प्रमाणीकरण प्रोफ़ाइलों का निरीक्षण करें:
openclaw models auth list --provider xai openclaw models status
xAI तय करता है कि किन खातों को OAuth API टोकन मिल सकते हैं। यदि कोई खाता पात्र नहीं है, तो API-कुंजी का तरीका उपयोग करें या xAI की ओर सदस्यता जाँचें।

SSH, Docker या VPS से साइन इन करते समय xai-oauth का उपयोग करें। OpenClaw एक URL और छोटा कोड दिखाता है; रिमोट प्रक्रिया द्वारा पूर्ण टोकन एक्सचेंज के लिए xAI को पोल किए जाने के दौरान किसी भी स्थानीय ब्राउज़र में साइन-इन पूरा करें।

अंतर्निहित कैटलॉग

मॉडल चयनकर्ताओं में चुनी जा सकने वाली आईडी। Plugin मौजूदा कॉन्फ़िगरेशन के लिए पुराने Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast और Grok Code आईडी का समाधान अब भी करता है; पुरानी संगतता और स्थानांतरित होने वाले उपनाम देखें।

परिवार	मॉडल आईडी
Grok 4.5	`grok-4.5` (उपनाम: `grok-4.5-latest`, `grok-build-latest`)
Grok Build 0.1	`grok-build-0.1`
Grok 4.3	`grok-4.3` (उपनाम: `grok-4.3-latest`, `grok-latest`)
Grok 4.20	`grok-4.20-0309-reasoning`, `grok-4.20-0309-non-reasoning`

जहाँ यह उपलब्ध हो, सामान्य चैट, कोडिंग और एजेंटिक कार्य के लिए grok-4.5 का उपयोग करें। Grok 4.3 क्षेत्रीय रूप से सुरक्षित सेटअप डिफ़ॉल्ट बना हुआ है; grok-build-0.1 और तारीख़ वाले दोनों Grok 4.20 प्रकार चुने जा सकते हैं।

कैटलॉग संदर्भ और टोकन-लागत मेटाडेटा xAI के लाइव मॉडल पृष्ठों और मूल्य निर्धारण पृष्ठ के अनुरूप हैं। जब कोई अनुरोध इसकी प्रलेखित दीर्घ-संदर्भ सीमा पार करता है, तो xAI अधिक दरें लागू करता है; OpenClaw के निश्चित कैटलॉग लागत फ़ील्ड अल्प-संदर्भ दरें दर्ज करते हैं। xAI का अलग कोडिंग-एजेंट CLI, Grok Build, x.ai/cli पर उपलब्ध है और वर्तमान में Grok 4.5 का उपयोग करता है।

सुविधा कवरेज

बंडल किया गया plugin समर्थित xAI API को OpenClaw के साझा प्रदाता और टूल अनुबंधों से मैप करता है। साझा अनुबंध में उपयुक्त न होने वाली क्षमताएँ नीचे या ज्ञात सीमाओं के अंतर्गत सूचीबद्ध हैं।

xAI क्षमता	OpenClaw सतह	स्थिति
चैट / प्रतिक्रियाएँ	`xai/<model>` मॉडल प्रदाता	हाँ
सर्वर-साइड वेब खोज	`web_search` प्रदाता `grok`	हाँ
सर्वर-साइड X खोज	`x_search` टूल	हाँ
सर्वर-साइड कोड निष्पादन	`code_execution` टूल	हाँ
छवियाँ	`image_generate`	हाँ
वीडियो	`video_generate`	हाँ
बैच टेक्स्ट-टू-स्पीच	`tts.provider: "xai"` / `tts`	हाँ
स्ट्रीमिंग TTS	`textToSpeechStream`	`wss://api.x.ai/v1/tts` के माध्यम से हाँ (रीयलटाइम वॉइस नहीं)
बैच स्पीच-टू-टेक्स्ट	`tools.media.audio` मीडिया समझ	हाँ
स्ट्रीमिंग स्पीच-टू-टेक्स्ट	वॉइस कॉल `streaming.provider: "xai"`	हाँ
रीयलटाइम वॉइस	टॉक `talk.realtime.provider: "xai"`	हाँ; नेटिव टॉक नोड्स के लिए Gateway-रिले
फ़ाइलें / बैच	केवल जेनेरिक मॉडल API संगतता	प्रथम-श्रेणी OpenClaw टूल नहीं

OpenClaw मीडिया जनरेशन और बैच ट्रांसक्रिप्शन के लिए xAI के REST इमेज/वीडियो/TTS/STT API, लाइव वॉइस-कॉल ट्रांसक्रिप्शन के लिए xAI के स्ट्रीमिंग STT WebSocket, टॉक रीयलटाइम सत्रों के लिए xAI के Grok Voice Agent WebSocket, और चैट, खोज तथा कोड-निष्पादन टूल के लिए Responses API का उपयोग करता है।

लीगेसी फ़ास्ट-मोड संगतता

/fast on या agents.defaults.models["xai/<model>"].params.fastMode: true अभी भी पुराने xAI कॉन्फ़िगरेशन को निम्न प्रकार से पुनर्लिखित करता है। ये लक्ष्य आईडी केवल संगतता के लिए रखी गई हैं; नए कॉन्फ़िगरेशन के लिए वर्तमान चयन योग्य मॉडल का उपयोग करें।

स्रोत मॉडल	फ़ास्ट-मोड लक्ष्य
`grok-3`	`grok-3-fast`
`grok-3-mini`	`grok-3-mini-fast`
`grok-4`	`grok-4-fast`
`grok-4-0709`	`grok-4-fast`

लीगेसी संगतता और परिवर्तनीय उपनाम

पुराने उपनाम निम्न प्रकार से सामान्यीकृत होते हैं:

लीगेसी उपनाम	सामान्यीकृत आईडी
`grok-code-fast-1`, `grok-code-fast`, `grok-code-fast-1-0825`	`grok-build-0.1`

तिथि वाले 0309 आईडी चयन योग्य कैटलॉग प्रविष्टियाँ हैं। OpenClaw अन्य सभी वर्तमान Grok 4.20 उपनामों को बिना बदलाव के भेजता है, ताकि xAI स्थिर, नवीनतम, बीटा, प्रायोगिक और तिथि वाले उपनामों के अर्थों पर नियंत्रण बनाए रखे। वैश्विक grok-latest उपनाम भी बिना बदलाव के संरक्षित रहता है। xAI ने निम्नलिखित सटीक आईडी समाप्त कर दी हैं। OpenClaw उन्हें जारी किए जा चुके कॉन्फ़िगरेशन के लिए छिपी हुई संगतता पंक्तियों के रूप में, उनके वर्तमान रीडायरेक्ट लक्ष्यों की सीमाओं और मूल्य निर्धारण के साथ रखता है:

समाप्त की गई आईडी	वर्तमान व्यवहार
`grok-4-1-fast-reasoning`, `grok-4-fast-reasoning`, `grok-4-0709`	`low` रीजनिंग के साथ Grok 4.3
`grok-4-1-fast-non-reasoning`, `grok-4-fast-non-reasoning`, `grok-3`	रीजनिंग अक्षम होने के साथ Grok 4.3
`grok-code-fast-1`	Grok Build 0.1
`grok-imagine-image-pro`	Grok Imagine इमेज गुणवत्ता

openclaw doctor --fix स्थायी xAI सर्वर-टूल डिफ़ॉल्ट और समाप्त किए गए गुणवत्ता इमेज स्लग को अपडेट करता है, पुराने जनरेट किए गए कैटलॉग पंक्तियों को हटाता है, और सक्रिय 4.20 पंक्तियों पर पुराने संदर्भ मेटाडेटा को सुधारता है। यह सक्रिय 4.20 beta-latest उपनामों को तिथि वाले स्नैपशॉट पर पिन नहीं करता।

सुविधाएँ

x_search और code_execution xAI के सर्वरों पर चलते हैं। xAI प्रति 1,000 टूल कॉल के लिए $5, साथ ही मॉडल के इनपुट और आउटपुट टोकन का शुल्क लेता है। प्रत्येक टूल की enabled सेटिंग छोड़े जाने पर, OpenClaw उसे केवल सक्रिय xAI मॉडल के लिए उपलब्ध कराता है। किसी ज्ञात गैर-xAI मॉडल प्रदाता के लिए स्पष्ट प्रति-टूल enabled: true आवश्यक है; अनुपस्थित या अनिर्धारित प्रदाता फ़ेल-क्लोज़ होता है। xAI प्रमाणीकरण हमेशा आवश्यक है, और enabled: false प्रत्येक प्रदाता के लिए टूल अक्षम करता है।

बंडल किया गया grok वेब-खोज प्रदाता पहले xAI OAuth को प्राथमिकता देता है, फिर XAI_API_KEY या किसी plugin वेब-खोज कुंजी पर फ़ॉलबैक करता है:

openclaw models auth login --provider xai --method oauth
openclaw config set tools.web.search.provider grok

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

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

डिफ़ॉल्ट मॉडल: xai/grok-imagine-video
अतिरिक्त मॉडल: xai/grok-imagine-video-1.5
क्लासिक मोड: टेक्स्ट-टू-वीडियो, इमेज-टू-वीडियो, संदर्भ-इमेज जनरेशन, रिमोट वीडियो संपादन और रिमोट वीडियो विस्तार
Video 1.5 मोड: केवल इमेज-टू-वीडियो, ठीक एक प्रथम-फ़्रेम इमेज के साथ
आस्पेक्ट रेशियो: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; छोड़े जाने पर क्लासिक और Video 1.5 इमेज-टू-वीडियो स्रोत इमेज का अनुपात अपनाते हैं
रिज़ॉल्यूशन: क्लासिक 480P/720P; Video 1.5 1080P का भी समर्थन करता है; सभी जनरेशन मोड का डिफ़ॉल्ट 480P है
अवधि: जनरेशन/इमेज-टू-वीडियो के लिए 1-15 सेकंड, क्लासिक reference_image भूमिकाओं का उपयोग करते समय 1-10 सेकंड, क्लासिक विस्तार के लिए 2-10 सेकंड
संदर्भ-इमेज जनरेशन: दी गई प्रत्येक इमेज के लिए imageRoles को reference_image पर सेट करें; xAI ऐसी अधिकतम 7 इमेज स्वीकार करता है
वीडियो संपादन/विस्तार इनपुट वीडियो का आस्पेक्ट रेशियो और रिज़ॉल्यूशन अपनाते हैं; ये संचालन ज्यामिति ओवरराइड स्वीकार नहीं करते
डिफ़ॉल्ट संचालन टाइमआउट: 600 सेकंड, जब तक video_generate.timeoutMs या agents.defaults.mediaModels.video.timeoutMs सेट न हो

स्थानीय वीडियो बफ़र स्वीकार नहीं किए जाते। वीडियो संपादन/विस्तार इनपुट के लिए रिमोट http(s) URL का उपयोग करें। इमेज-टू-वीडियो स्थानीय इमेज बफ़र स्वीकार करता है, क्योंकि OpenClaw उन्हें xAI के लिए डेटा URL के रूप में एन्कोड करता है।

Video 1.5 xAI के grok-imagine-video-1.5-preview और grok-imagine-video-1.5-2026-05-30 पहचानकर्ताओं को भी पहचानता है। OpenClaw चयनित पहचानकर्ता को बिना बदलाव के अग्रेषित करता है, लेकिन वही केवल-इमेज सत्यापन लागू करता है।xAI को डिफ़ॉल्ट वीडियो प्रदाता के रूप में उपयोग करने के लिए:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}

साझा टूल पैरामीटर, प्रदाता चयन और फ़ेलओवर व्यवहार के लिए वीडियो जनरेशन देखें।

इमेज जनरेशन

बंडल किया गया xai Plugin, साझा image_generate टूल के माध्यम से इमेज जनरेशन पंजीकृत करता है।

डिफ़ॉल्ट इमेज मॉडल: xai/grok-imagine-image
अतिरिक्त मॉडल: xai/grok-imagine-image-quality
मोड: टेक्स्ट-टू-इमेज और संदर्भ-इमेज संपादन
संदर्भ इनपुट: एक image या अधिकतम तीन images
आस्पेक्ट रेशियो: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
रिज़ॉल्यूशन: 1K, 2K
संख्या: अधिकतम 4 इमेज
डिफ़ॉल्ट ऑपरेशन टाइमआउट: 600 सेकंड, जब तक image_generate.timeoutMs या agents.defaults.mediaModels.image.timeoutMs सेट न हो

OpenClaw, xAI से b64_json इमेज प्रतिक्रियाएँ माँगता है ताकि जनरेट किया गया मीडिया सामान्य चैनल अटैचमेंट पथ से संग्रहीत और वितरित किया जा सके। स्थानीय संदर्भ इमेज को डेटा URL में बदला जाता है; रिमोट http(s) संदर्भ बिना बदलाव के आगे भेजे जाते हैं।xAI को डिफ़ॉल्ट इमेज प्रदाता के रूप में उपयोग करने के लिए:

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "xai/grok-imagine-image",
      },
    },
  },
}

xAI, quality, mask, user और एक auto आस्पेक्ट रेशियो का भी दस्तावेज़ीकरण करता है। OpenClaw वर्तमान में केवल साझा क्रॉस-प्रदाता इमेज नियंत्रण आगे भेजता है; केवल नेटिव ये नियंत्रण image_generate के माध्यम से उपलब्ध नहीं हैं।

टेक्स्ट-टू-स्पीच

बंडल किया गया xai Plugin, साझा tts प्रदाता सतह के माध्यम से टेक्स्ट-टू-स्पीच पंजीकृत करता है।

वॉइस: xAI से प्रमाणित लाइव कैटलॉग; इसे openclaw infer tts voices --provider xai से सूचीबद्ध करें
ऑफ़लाइन फ़ॉलबैक वॉइस: ara, eve, leo, rex, sal
डिफ़ॉल्ट वॉइस: eve
खाते की कस्टम वॉइस ID को तब भी आगे भेजा जाता है, जब वे अंतर्निहित कैटलॉग प्रतिक्रिया में मौजूद न हों
फ़ॉर्मैट: mp3, wav, pcm, mulaw, alaw
भाषा: BCP-47 कोड या auto
गति: प्रदाता-नेटिव गति ओवरराइड
नेटिव Opus वॉइस-नोट फ़ॉर्मैट समर्थित नहीं है

xAI को डिफ़ॉल्ट TTS प्रदाता के रूप में उपयोग करने के लिए:

{
  tts: {
    provider: "xai",
    providers: {
      xai: {
        voiceId: "eve",
      },
    },
  },
}

OpenClaw बफ़र किए गए संश्लेषण के लिए xAI के बैच /v1/tts एंडपॉइंट, प्रमाणित /v1/tts/voices कैटलॉग खोज और स्ट्रीमिंग संश्लेषण के लिए नेटिव wss://api.x.ai/v1/tts का उपयोग करता है। स्ट्रीमिंग नेटिव api.x.ai होस्ट तक सीमित है, इसलिए इस पथ पर कस्टम baseUrl मान अस्वीकार किए जाते हैं। यह मौजूदा भाषा, वॉइस, कोडेक और गति नियंत्रणों का उपयोग करता है; सैंपल रेट और बिट रेट पर xAI के डिफ़ॉल्ट लागू होते हैं। ऑडियो-फ़ाइल संश्लेषण सभी कॉन्फ़िगर किए गए कोडेक का पालन करता है। वॉइस-नोट लक्ष्य स्ट्रीमिंग और बफ़र किए गए फ़ॉलबैक के लिए MP3 का उपयोग करते हैं, क्योंकि xAI के रॉ कोडेक में कोडेक/रेट मेटाडेटा नहीं होता। स्ट्रीम text.delta और फिर text.done भेजती है, audio.delta, audio.done या error प्राप्त करती है और एक निष्क्रिय timeoutMs लागू करती है, जो प्रत्येक ऑडियो खंड पर रीफ़्रेश होता है। यह रियलटाइम वॉइस सत्रों से अलग है। xAI का स्ट्रीमिंग TTS API अनुबंध देखें।

स्पीच-टू-टेक्स्ट

बंडल किया गया xai Plugin, OpenClaw की मीडिया-अंडरस्टैंडिंग ट्रांसक्रिप्शन सतह के माध्यम से बैच स्पीच-टू-टेक्स्ट पंजीकृत करता है।

एंडपॉइंट: xAI REST /v1/stt
इनपुट पथ: मल्टीपार्ट ऑडियो फ़ाइल अपलोड
मॉडल चयन: xAI ट्रांसक्रिप्शन मॉडल को आंतरिक रूप से चुनता है; एंडपॉइंट में कोई मॉडल चयनकर्ता नहीं है
जहाँ भी आने वाले ऑडियो का ट्रांसक्रिप्शन tools.media.audio पढ़ता है, वहाँ इसका उपयोग होता है, जिसमें Discord वॉइस-चैनल खंड और चैनल ऑडियो अटैचमेंट शामिल हैं

आने वाले ऑडियो के ट्रांसक्रिप्शन के लिए xAI को अनिवार्य करने हेतु:

{
  tools: {
    media: {
      audio: {
        models: [
          {
            type: "provider",
            provider: "xai",
          },
        ],
      },
    },
  },
}

भाषा को साझा ऑडियो मीडिया कॉन्फ़िग या प्रत्येक कॉल के ट्रांसक्रिप्शन अनुरोध के माध्यम से दिया जा सकता है। प्रॉम्प्ट संकेत साझा OpenClaw सतह स्वीकार करती है, लेकिन xAI REST STT एकीकरण केवल फ़ाइल और भाषा आगे भेजता है, क्योंकि वर्तमान सार्वजनिक xAI एंडपॉइंट से केवल इन्हीं की मैपिंग होती है।

स्ट्रीमिंग स्पीच-टू-टेक्स्ट

बंडल किया गया xai Plugin, लाइव वॉइस-कॉल ऑडियो के लिए एक रियलटाइम ट्रांसक्रिप्शन प्रदाता भी पंजीकृत करता है।

एंडपॉइंट: xAI WebSocket wss://api.x.ai/v1/stt
डिफ़ॉल्ट एन्कोडिंग: mulaw
डिफ़ॉल्ट सैंपल रेट: 8000
डिफ़ॉल्ट एंडपॉइंटिंग: 800ms
अंतरिम ट्रांसक्रिप्ट: डिफ़ॉल्ट रूप से सक्षम

Voice Call की Twilio मीडिया स्ट्रीम G.711 mu-law ऑडियो फ़्रेम भेजती है, इसलिए xAI प्रदाता उन फ़्रेम को बिना ट्रांसकोडिंग के सीधे आगे भेजता है:

{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "xai",
            providers: {
              xai: {
                apiKey: "${XAI_API_KEY}",
                endpointingMs: 800,
                language: "en",
              },
            },
          },
        },
      },
    },
  },
}

प्रदाता-स्वामित्व वाला कॉन्फ़िग plugins.entries.voice-call.config.streaming.providers.xai के अंतर्गत होता है। समर्थित कुंजियाँ apiKey, baseUrl, sampleRate, encoding (pcm, mulaw या alaw), interimResults, endpointingMs और language हैं।

यह स्ट्रीमिंग प्रदाता Voice Call के रियलटाइम ट्रांसक्रिप्शन पथ के लिए है। Discord वॉइस छोटे खंड रिकॉर्ड करता है और इसके बजाय बैच tools.media.audio ट्रांसक्रिप्शन पथ का उपयोग करता है।

रियलटाइम वॉइस (Talk)

बंडल किया गया xai Plugin, साझा registerRealtimeVoiceProvider अनुबंध के माध्यम से Talk मोड के लिए Grok Voice Agent रियलटाइम सत्र पंजीकृत करता है।

एंडपॉइंट: wss://api.x.ai/v1/realtime?model=<voice-model>
डिफ़ॉल्ट मॉडल: grok-voice-latest
डिफ़ॉल्ट वॉइस: eve
ट्रांसपोर्ट: gateway-relay (iOS, Android और Control UI रिले पथ)
ऑडियो: PCM16 24 kHz या G.711 µ-law 8 kHz
बात काटना: xAI सर्वर VAD प्रतिक्रिया को बाधित करता है; OpenClaw कतारबद्ध प्लेबैक साफ़ करता है और न चलाए गए प्रदाता इतिहास को छोटा करता है

Gateway पर Talk कॉन्फ़िगर करें:

{
  talk: {
    realtime: {
      provider: "xai",
      mode: "realtime",
      transport: "gateway-relay",
      brain: "agent-consult",
      providers: {
        xai: {
          model: "grok-voice-latest",
          voice: "eve",
          // केवल तभी सहमति दें जब प्रदाता-पक्षीय सत्र रीप्ले स्वीकार्य हो।
          sessionResumption: false,
        },
      },
    },
  },
  env: { XAI_API_KEY: "xai-..." },
}

जब Voice Call या साझा रियलटाइम चयनकर्ता उसी प्रदाता मैप का पुनः उपयोग करते हैं, तब प्रदाता-स्वामित्व वाला कॉन्फ़िग plugins.entries.voice-call.config.realtime.providers.xai से भी निर्धारित होता है। समर्थित कुंजियाँ apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs, prefixPaddingMs, reasoningEffort और sessionResumption हैं। xAI Voice Agent API के अनुरूप, reasoningEffort केवल high या none स्वीकार करता है।xAI का सर्वर VAD हमेशा प्रतिक्रियाएँ बनाता है और ऑडियो व्यवधान संभालता है। consultRouting: "provider-direct" का उपयोग करें; xAI Voice Agent प्रोटोकॉल जबरन ट्रांसक्रिप्ट रूटिंग और इनपुट-ऑडियो व्यवधान को अक्षम करने का समर्थन नहीं करता।

xAI OAuth या XAI_API_KEY रियलटाइम वॉइस को प्रमाणित कर सकते हैं। ब्राउज़र-स्वामित्व वाला WebRTC अभी इस प्रदाता सतह का हिस्सा नहीं है; नेटिव Node या Control UI रिले पथ पर gateway-relay Talk का उपयोग करें।

sessionResumption का डिफ़ॉल्ट false है। इसे true पर सेट करने पर OpenClaw, xAI से पर्याप्त सत्र स्थिति बनाए रखने के लिए कहता है, ताकि दोबारा कनेक्ट होने के बाद वही बातचीत फिर शुरू की जा सके, और फिर लौटाई गई बातचीत ID के साथ दोबारा कनेक्ट होता है। जब प्रदाता-पक्षीय रीप्ले/प्रतिधारण स्वीकार्य न हो, तो इसे अक्षम रखें; तब बाधित सॉकेट चुपचाप नई बातचीत शुरू करने के बजाय बंद होकर विफल होते हैं।

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

बंडल किया गया xAI Plugin, Grok के माध्यम से X (पूर्व में Twitter) सामग्री खोजने के लिए x_search को OpenClaw टूल के रूप में उपलब्ध कराता है।कॉन्फ़िग पथ: plugins.entries.xai.config.xSearch

कुंजी	प्रकार	डिफ़ॉल्ट	विवरण
`enabled`	बूलियन	xAI मॉडल के लिए स्वचालित	अक्षम करें, या किसी ज्ञात गैर-xAI प्रदाता के लिए सहमति दें
`model`	स्ट्रिंग	`grok-4.3`	x_search अनुरोधों के लिए उपयोग किया गया मॉडल
`baseUrl`	स्ट्रिंग	-	xAI Responses आधार URL ओवरराइड
`inlineCitations`	बूलियन	-	परिणामों में इनलाइन उद्धरण शामिल करें
`maxTurns`	संख्या	-	बातचीत के अधिकतम चरण
`timeoutSeconds`	संख्या	`30`	अनुरोध टाइमआउट, सेकंड में
`cacheTtlMinutes`	संख्या	`15`	कैश टाइम-टू-लाइव, मिनट में

{
  plugins: {
    entries: {
      xai: {
        config: {
          xSearch: {
            enabled: true,
            model: "grok-4.3",
            baseUrl: "https://api.x.ai/v1",
            inlineCitations: true,
          },
        },
      },
    },
  },
}

कोड निष्पादन कॉन्फ़िगरेशन

बंडल किया गया xAI Plugin, xAI के सैंडबॉक्स परिवेश में रिमोट कोड निष्पादन के लिए code_execution को OpenClaw टूल के रूप में उपलब्ध कराता है।कॉन्फ़िग पथ: plugins.entries.xai.config.codeExecution

कुंजी	प्रकार	डिफ़ॉल्ट	विवरण
`enabled`	boolean	xAI मॉडल के लिए स्वचालित	अक्षम करें, या किसी ज्ञात गैर-xAI प्रदाता के लिए विकल्प चुनें
`model`	string	`grok-4.3`	कोड निष्पादन अनुरोधों के लिए उपयोग किया जाने वाला मॉडल
`maxTurns`	number	-	वार्तालाप के अधिकतम चरण
`timeoutSeconds`	number	`30`	सेकंड में अनुरोध की समय-सीमा

यह दूरस्थ xAI सैंडबॉक्स निष्पादन है, स्थानीय exec नहीं।

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4.3",
          },
        },
      },
    },
  },
}

ज्ञात सीमाएँ

xAI प्रमाणीकरण API कुंजी, पर्यावरण चर, Plugin कॉन्फ़िगरेशन फ़ॉलबैक, या पात्र xAI खाते के साथ OAuth का उपयोग कर सकता है। OAuth बिना localhost कॉलबैक के डिवाइस-कोड सत्यापन का उपयोग करता है। xAI तय करता है कि किन खातों को OAuth API टोकन मिल सकते हैं, और सहमति पृष्ठ पर Grok Build दिखाई दे सकता है, भले ही OpenClaw को Grok Build ऐप की आवश्यकता नहीं है।
OpenClaw वर्तमान में xAI मल्टी-एजेंट मॉडल परिवार को उपलब्ध नहीं कराता। xAI इन मॉडलों को Responses API के माध्यम से प्रस्तुत करता है, लेकिन वे OpenClaw के साझा एजेंट लूप द्वारा उपयोग किए जाने वाले क्लाइंट-साइड या कस्टम टूल स्वीकार नहीं करते। देखें xAI मल्टी-एजेंट सीमाएँ।
xAI Realtime वॉइस वर्तमान में केवल gateway-relay Talk ट्रांसपोर्ट उपलब्ध कराती है। ब्राउज़र के स्वामित्व वाले प्रदाता WebSocket सत्र अभी Control UI में जोड़े नहीं गए हैं।
xAI इमेज quality, इमेज mask, और अतिरिक्त केवल-नेटिव आस्पेक्ट रेशियो तब तक उपलब्ध नहीं कराए जाते, जब तक साझा image_generate टूल में उनके अनुरूप क्रॉस-प्रदाता नियंत्रण न हों।

उन्नत टिप्पणियाँ

OpenClaw साझा रनर पथ पर xAI-विशिष्ट टूल-स्कीमा और टूल-कॉल संगतता सुधार स्वचालित रूप से लागू करता है।
नेटिव xAI अनुरोधों का डिफ़ॉल्ट tool_stream: true है। इसे अक्षम करने के लिए agents.defaults.models["xai/<model>"].params.tool_stream को false पर सेट करें।
बंडल किया गया xAI रैपर नेटिव xAI अनुरोध भेजने से पहले असमर्थित contains-count स्कीमा सीमाएँ और असमर्थित रीजनिंग effort पेलोड कुंजियाँ हटा देता है। Grok 4.5 निम्न, मध्यम और उच्च effort (डिफ़ॉल्ट उच्च) का समर्थन करता है। Grok 4.3 कोई नहीं, निम्न, मध्यम और उच्च effort (डिफ़ॉल्ट निम्न) का समर्थन करता है। रीजनिंग में सक्षम अन्य xAI मॉडल कॉन्फ़िगर करने योग्य effort नियंत्रण उपलब्ध नहीं कराते, लेकिन फिर भी include: ["reasoning.encrypted_content"] का अनुरोध करते हैं, ताकि पहले की एन्क्रिप्टेड रीजनिंग को बाद के चरणों में फिर से चलाया जा सके।
web_search, x_search, और code_execution को OpenClaw टूल के रूप में उपलब्ध कराया जाता है। प्रत्येक चैट चरण में हर नेटिव टूल जोड़ने के बजाय, OpenClaw प्रत्येक टूल के अनुरोध में केवल वही विशिष्ट xAI बिल्ट-इन जोड़ता है जिसकी उस टूल को आवश्यकता होती है।
Grok web_search, plugins.entries.xai.config.webSearch.baseUrl को पढ़ता है। x_search, plugins.entries.xai.config.xSearch.baseUrl को पढ़ता है, फिर Grok वेब-सर्च बेस URL पर फ़ॉलबैक करता है।
x_search और code_execution को कोर मॉडल रनटाइम में हार्डकोड करने के बजाय बंडल किया गया xAI Plugin उनका स्वामी है।
code_execution दूरस्थ xAI सैंडबॉक्स निष्पादन है, स्थानीय exec नहीं।

लाइव परीक्षण

xAI मीडिया पथ यूनिट परीक्षणों और विकल्प-आधारित लाइव सुइट द्वारा कवर किए जाते हैं। लाइव प्रोब चलाने से पहले प्रोसेस वातावरण में XAI_API_KEY एक्सपोर्ट करें।

pnpm test extensions/xai
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/xai.live.test.ts
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "classic Grok Imagine"
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "Grok Imagine Video 1.5"
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/x-search.live.test.ts
OPENCLAW_LIVE_GATEWAY_MODELS="xai/grok-4.5,xai/grok-build-0.1,xai/grok-4.3,xai/grok-4.20-0309-reasoning,xai/grok-4.20-0309-non-reasoning" OPENCLAW_LIVE_GATEWAY_MAX_MODELS=0 OPENCLAW_LIVE_GATEWAY_SMOKE=0 pnpm test:live -- src/gateway/gateway-models.profiles.live.test.ts
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS=xai pnpm test:live -- test/image-generation.runtime.live.test.ts

प्रदाता-विशिष्ट लाइव फ़ाइल सामान्य TTS और टेलीफ़ोनी-अनुकूल PCM TTS संश्लेषित करती है, xAI बैच STT के माध्यम से ऑडियो का लिप्यंतरण करती है, उसी PCM को xAI रीयलटाइम STT के माध्यम से स्ट्रीम करती है, टेक्स्ट-टू-इमेज आउटपुट जनरेट करती है, और एक संदर्भ इमेज संपादित करती है। साझा इमेज लाइव फ़ाइल OpenClaw के रनटाइम चयन, फ़ॉलबैक, सामान्यीकरण और मीडिया अटैचमेंट पथ के माध्यम से उसी xAI प्रदाता को सत्यापित करती है। विकल्प-आधारित Video 1.5 केस 1080P पर एक जनरेट की गई प्रथम-फ़्रेम इमेज सबमिट करता है और पूर्ण हुए वीडियो के डाउनलोड को सत्यापित करता है।

मॉडल चयन

प्रदाताओं, मॉडल संदर्भों और फ़ेलओवर व्यवहार का चयन।

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

साझा वीडियो टूल के पैरामीटर और प्रदाता चयन।

सभी प्रदाता

प्रदाताओं का विस्तृत अवलोकन।

समस्या निवारण

सामान्य समस्याएँ और समाधान।

Overview

Concepts and configuration

Providers

सेटअप

OAuth समस्या निवारण

अंतर्निहित कैटलॉग

सुविधा कवरेज

लीगेसी फ़ास्ट-मोड संगतता

लीगेसी संगतता और परिवर्तनीय उपनाम

सुविधाएँ

लाइव परीक्षण

संबंधित

मॉडल चयन

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

सभी प्रदाता

समस्या निवारण

​सेटअप

​OAuth समस्या निवारण

​अंतर्निहित कैटलॉग

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

​लीगेसी फ़ास्ट-मोड संगतता

​लीगेसी संगतता और परिवर्तनीय उपनाम

​सुविधाएँ

​लाइव परीक्षण

​संबंधित

मॉडल चयन

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

सभी प्रदाता

समस्या निवारण

सेटअप

OAuth समस्या निवारण

अंतर्निहित कैटलॉग

सुविधा कवरेज

लीगेसी फ़ास्ट-मोड संगतता

लीगेसी संगतता और परिवर्तनीय उपनाम

सुविधाएँ

लाइव परीक्षण

संबंधित