اجرای کد

code_execution تحلیل Python راه دور و سندباکس‌شده را روی Responses API شرکت xAI اجرا می‌کند. این ابزار توسط Plugin همراه xai (زیر قرارداد tools) ثبت می‌شود و به همان نقطه پایانی https://api.x.ai/v1/responses ارسال می‌کند که x_search از آن استفاده می‌کند.

این با exec محلی تفاوت دارد:

• exec فرمان‌های shell را روی ماشین شما یا node جفت‌شده اجرا می‌کند.
• code_execution، Python را در sandbox راه دور xAI اجرا می‌کند.

از code_execution برای این موارد استفاده کنید:

• محاسبات.
• جدول‌بندی.
• آمار سریع.
• تحلیل به سبک نمودار.
• تحلیل داده‌های بازگردانده‌شده توسط x_search یا web_search.

وقتی به فایل‌های محلی، shell، repo یا دستگاه‌های جفت‌شده نیاز دارید از آن استفاده نکنید. برای این کار از exec استفاده کنید.

راه‌اندازی

export XAI_API_KEY=xai-...

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...",          },        },      },    },  },}

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

openclaw gateway restart

نحوه استفاده از آن

طبیعی درخواست کنید و هدف تحلیل را صریح بیان کنید:

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 می‌گیرد، بنابراین agent باید درخواست کامل تحلیل و هر داده درون‌خطی را در یک prompt ارسال کند.

خطاها

وقتی ابزار بدون احراز هویت اجرا شود، یک خطای ساختاریافته missing_xai_api_key برمی‌گرداند که به گزینه‌های auth-profile، متغیر محیطی و پیکربندی اشاره می‌کند. خطا JSON است، نه یک استثنای پرتاب‌شده، بنابراین agent می‌تواند خودش آن را اصلاح کند:

{  "error": "missing_xai_api_key",  "message": "code_execution needs an xAI API key. 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 است، نه اجرای فرایند محلی.
• نتایج را تحلیل زودگذر در نظر بگیرید، نه یک جلسه notebook پایدار.
• دسترسی به فایل‌های محلی یا workspace خود را فرض نکنید.
• برای داده‌های تازه X، ابتدا از x_search استفاده کنید و نتیجه را به code_execution لوله کنید.

مرتبط