اجرای کد

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

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

• exec فرمان‌های پوسته را روی ماشین شما یا Node جفت‌شده اجرا می‌کند.
• code_execution، Python را در محیط ایزولهٔ راه دور xAI اجرا می‌کند.

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

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

وقتی به فایل‌های محلی، پوسته، مخزن، یا دستگاه‌های جفت‌شده نیاز دارید، از آن استفاده نکنید. برای این کار از 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 می‌گیرد، بنابراین عامل باید کل درخواست تحلیل و هر دادهٔ درون‌خطی را در یک پرامپت بفرستد.

# خطاها

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

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

# مرتبط