Tools
कोड निष्पादन
code_execution xAI के Responses API पर सैंडबॉक्सयुक्त रिमोट Python विश्लेषण चलाता है
(https://api.x.ai/v1/responses, वही एंडपॉइंट जिसका उपयोग x_search करता है)। इसे
बंडल किए गए xai Plugin द्वारा tools अनुबंध के अंतर्गत पंजीकृत किया जाता है।
| प्रॉपर्टी | मान |
|---|---|
| टूल का नाम | code_execution |
| प्रदाता Plugin | xai (बंडल किया गया, enabledByDefault: true) |
| प्रमाणीकरण | xAI प्रमाणीकरण प्रोफ़ाइल, XAI_API_KEY, या plugins.entries.xai.config.webSearch.apiKey |
| डिफ़ॉल्ट मॉडल | grok-4.3 |
| डिफ़ॉल्ट टाइमआउट | 30 सेकंड |
डिफ़ॉल्ट maxTurns |
सेट नहीं (xAI अपनी आंतरिक सीमा लागू करता है) |
इसका उपयोग गणनाओं, सारणीकरण, त्वरित सांख्यिकी और चार्ट-शैली के
विश्लेषण के लिए करें, जिसमें x_search या web_search द्वारा लौटाया गया डेटा भी शामिल है। इसे
स्थानीय फ़ाइलों, आपके शेल, आपके रेपो या युग्मित डिवाइसों तक कोई
पहुँच नहीं है, और यह कॉल के बीच स्थिति को बनाए नहीं रखता, इसलिए प्रत्येक कॉल को क्षणिक विश्लेषण मानें,
न कि नोटबुक सत्र। नवीनतम X डेटा के लिए, पहले x_search
चलाएँ और परिणाम को इसमें पाइप करें।
स्थानीय निष्पादन के लिए, इसके बजाय exec का उपयोग करें।
सेटअप
xAI क्रेडेंशियल प्रदान करें
OAuth के लिए योग्य SuperGrok या X Premium सदस्यता आवश्यक है (डिवाइस-कोड सत्यापन, इसलिए यह localhost कॉलबैक के बिना रिमोट होस्ट से काम करता है):
openclaw models auth login --provider xai --method oauthनए इंस्टॉलेशन के दौरान, यही विकल्प ऑनबोर्डिंग में उपलब्ध होता है:
openclaw onboard --install-daemon --auth-choice xai-oauthया API कुंजी:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...या कॉन्फ़िगरेशन के माध्यम से:
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}इन तीनों में से कोई भी x_search और Grok web_search को भी संचालित करता है।
code_execution सक्षम और अनुकूलित करें
enabled को छोड़ देने पर, code_execution केवल तभी उपलब्ध कराया जाता है जब सक्रिय
मॉडल का प्रदाता xai हो और xAI क्रेडेंशियल उपलब्ध हों। ज्ञात गैर-xAI प्रदाता वाले सक्रिय मॉडल
के लिए, क्रॉस-प्रदाता उपयोग को स्वीकार करने हेतु
plugins.entries.xai.config.codeExecution.enabled को true पर सेट करें।
यदि सक्रिय मॉडल प्रदाता अनुपस्थित है या उसका समाधान नहीं हो पाता,
तो टूल छिपा रहता है। इसे प्रत्येक प्रदाता के लिए अक्षम करने हेतु enabled को false पर सेट करें।
xAI क्रेडेंशियल हमेशा आवश्यक होते हैं।
मॉडल, टर्न सीमा या टाइमआउट को ओवरराइड करने के लिए इसी ब्लॉक का उपयोग करें:
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, // ज्ञात गैर-xAI मॉडल प्रदाता के लिए आवश्यक model: "grok-4.3", // डिफ़ॉल्ट xAI कोड-निष्पादन मॉडल को ओवरराइड करें maxTurns: 2, // आंतरिक टूल टर्न की वैकल्पिक सीमा timeoutSeconds: 30, // अनुरोध टाइमआउट (डिफ़ॉल्ट: 30) }, }, }, }, },}Gateway पुनः आरंभ करें
openclaw gateway restartxAI Plugin के पुनः पंजीकृत होने और ऊपर दिए गए प्रदाता, सक्षमता तथा प्रमाणीकरण जाँचों के सफल होने पर
code_execution एजेंट की टूल सूची में दिखाई देता है।
इसका उपयोग कैसे करें
विश्लेषण के उद्देश्य को स्पष्ट बनाएँ; टूल एकल task पैरामीटर लेता है,
इसलिए पूरा अनुरोध और कोई भी इनलाइन डेटा एक ही प्रॉम्प्ट में भेजें:
इन संख्याओं के लिए 7-दिवसीय मूविंग एवरेज की गणना करने हेतु code_execution का उपयोग करें: ...इस सप्ताह OpenClaw का उल्लेख करने वाली पोस्ट खोजने हेतु x_search का उपयोग करें, फिर उन्हें दिन के अनुसार गिनने हेतु code_execution का उपयोग करें।नवीनतम AI बेंचमार्क संख्याएँ एकत्र करने हेतु web_search का उपयोग करें, फिर प्रतिशत परिवर्तनों की तुलना करने हेतु code_execution का उपयोग करें।त्रुटियाँ
प्रमाणीकरण के बिना, टूल एक संरचित JSON त्रुटि लौटाता है (थ्रो किया गया अपवाद नहीं), ताकि एजेंट स्वयं सुधार कर सके:
{ "error": "missing_xai_api_key", "message": "code_execution के लिए xAI क्रेडेंशियल आवश्यक हैं। Grok से साइन इन करने के लिए `openclaw onboard --auth-choice xai-oauth` चलाएँ, `openclaw onboard --auth-choice xai-api-key` चलाएँ, Gateway परिवेश में `XAI_API_KEY` सेट करें, या `plugins.entries.xai.config.webSearch.apiKey` कॉन्फ़िगर करें।", "docs": "https://docs.openclaw.ai/tools/code-execution"}