اجرای کد

code_execution تحلیل Python راه‌دور و sandboxشده را روی 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، مخزن، یا دستگاه‌های جفت‌شده نیاز دارید، از آن استفاده نکنید. برای این کار از exec استفاده کنید.

راه‌اندازی

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

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

openclaw models auth login --provider xai --method api-keyexport 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 می‌گیرد، بنابراین عامل باید کل درخواست تحلیل و هر داده درون‌خطی را در یک prompt ارسال کند.

خطاها

وقتی ابزار بدون احراز هویت اجرا شود، یک خطای ساخت‌یافته missing_xai_api_key برمی‌گرداند که به گزینه‌های نمایه احراز هویت، متغیر محیطی، و پیکربندی اشاره می‌کند. خطا JSON است، نه exception پرتاب‌شده، بنابراین عامل می‌تواند خودش اصلاح کند:

{  "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 است، نه اجرای فرایند محلی.
• نتایج را تحلیل گذرا در نظر بگیرید، نه یک نشست notebook پایدار.
• دسترسی به فایل‌های محلی یا فضای کاری خود را فرض نکنید.
• برای داده‌های تازه X، ابتدا از x_search استفاده کنید و نتیجه را به code_execution بدهید.

مرتبط