Tools
कोड निष्पादन
code_execution xAI के Responses API पर सैंडबॉक्स किए गए रिमोट Python विश्लेषण चलाता है। इसे बंडल किए गए xai Plugin द्वारा (tools अनुबंध के अंतर्गत) पंजीकृत किया जाता है और यह उसी https://api.x.ai/v1/responses एंडपॉइंट पर भेजता है जिसका उपयोग x_search करता है।
| गुण | मान |
|---|---|
| टूल नाम | code_execution |
| Provider Plugin | xai (बंडल किया गया, enabledByDefault: true) |
| Auth | xAI auth प्रोफ़ाइल, XAI_API_KEY, या plugins.entries.xai.config.webSearch.apiKey |
| डिफ़ॉल्ट मॉडल | grok-4-1-fast |
| डिफ़ॉल्ट टाइमआउट | 30 सेकंड |
डिफ़ॉल्ट maxTurns |
सेट नहीं (xAI अपनी आंतरिक सीमा लागू करता है) |
यह स्थानीय exec से अलग है:
execआपकी मशीन या paired node पर shell कमांड चलाता है।code_executionxAI के रिमोट सैंडबॉक्स में Python चलाता है।
code_execution का उपयोग इनके लिए करें:
- गणनाएं।
- सारणीकरण।
- त्वरित सांख्यिकी।
- चार्ट-शैली विश्लेषण।
x_searchयाweb_searchद्वारा लौटाए गए डेटा का विश्लेषण।
जब आपको स्थानीय फ़ाइलों, अपने shell, अपने repo, या paired devices की आवश्यकता हो, तो इसका उपयोग न करें। उसके लिए exec का उपयोग करें।
सेटअप
xAI credentials प्रदान करें
पात्र SuperGrok या X Premium सदस्यता का उपयोग करके Grok OAuth से साइन इन करें,
या API key संग्रहीत करें। xAI OAuth device-code verification का उपयोग करता है, इसलिए यह
localhost callback के बिना रिमोट hosts से काम करता है। OAuth
code_execution और x_search के लिए काम करता है; XAI_API_KEY या Plugin web-search config
Grok web_search को भी चला सकते हैं।
openclaw models auth login --provider xai --method oauthनए install के दौरान, वही auth विकल्प onboarding के अंदर उपलब्ध होते हैं:
openclaw onboard --install-daemonopenclaw onboard --install-daemon --auth-choice xai-oauthया API key का उपयोग करें:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...या config के माध्यम से:
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}code_execution सक्षम और ट्यून करें
xAI credentials उपलब्ध होने पर code_execution उपलब्ध होता है। इसे अक्षम करने के लिए
plugins.entries.xai.config.codeExecution.enabled को false पर सेट करें,
या model और timeout को ट्यून करने के लिए उसी block का उपयोग करें।
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, model: "grok-4-1-fast", // override the default xAI code-execution model maxTurns: 2, // optional cap on internal tool turns timeoutSeconds: 30, // request timeout (default: 30) }, }, }, }, },}Gateway को restart करें
openclaw gateway restartxAI Plugin के enabled: true के साथ फिर से register होने के बाद code_execution agent की tool list में दिखाई देता है।
इसका उपयोग कैसे करें
स्वाभाविक रूप से पूछें और विश्लेषण का उद्देश्य स्पष्ट करें:
Use code_execution to calculate the 7-day moving average for these numbers: ...Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.टूल आंतरिक रूप से एक ही task parameter लेता है, इसलिए agent को पूरा analysis request और कोई भी inline data एक prompt में भेजना चाहिए।
त्रुटियां
जब टूल auth के बिना चलता है, तो यह auth-profile, env var, और config विकल्पों की ओर संकेत करने वाली संरचित missing_xai_api_key error लौटाता है। error JSON है, thrown exception नहीं, इसलिए agent स्वयं सुधार कर सकता है:
{ "error": "missing_xai_api_key", "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, run `openclaw onboard --auth-choice xai-api-key`, set `XAI_API_KEY` in the Gateway environment, or configure `plugins.entries.xai.config.webSearch.apiKey`.", "docs": "https://docs.openclaw.ai/tools/code-execution"}सीमाएं
- यह रिमोट xAI execution है, स्थानीय process execution नहीं।
- परिणामों को ephemeral analysis मानें, persistent notebook session नहीं।
- स्थानीय फ़ाइलों या अपने workspace तक access मानकर न चलें।
- ताज़ा X data के लिए, पहले
x_searchका उपयोग करें और परिणाम कोcode_executionमें pipe करें।