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_execution xAI के रिमोट सैंडबॉक्स में 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 को भी चला सकते हैं।

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

    नए install के दौरान, वही auth विकल्प onboarding के अंदर उपलब्ध होते हैं:

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

    या API key का उपयोग करें:

    bash
    openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...

    या config के माध्यम से:

    json5
    {  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...",          },        },      },    },  },}
  • code_execution सक्षम और ट्यून करें

    xAI credentials उपलब्ध होने पर code_execution उपलब्ध होता है। इसे अक्षम करने के लिए plugins.entries.xai.config.codeExecution.enabled को false पर सेट करें, या model और timeout को ट्यून करने के लिए उसी block का उपयोग करें।

    json5
    {  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 करें

    bash
    openclaw gateway restart

    xAI Plugin के enabled: true के साथ फिर से register होने के बाद code_execution agent की tool list में दिखाई देता है।

  • इसका उपयोग कैसे करें

    स्वाभाविक रूप से पूछें और विश्लेषण का उद्देश्य स्पष्ट करें:

    text
    Use code_execution to calculate the 7-day moving average for these numbers: ...
    text
    Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.
    text
    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 स्वयं सुधार कर सकता है:

    json
    {  "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 करें।

    संबंधित

    Was this useful?
    On this page

    On this page