الانتقال إلى المحتوى الرئيسي
يشغّل code_execution تحليلاً بعيداً للغة Python داخل sandbox على واجهة Responses API الخاصة بـ xAI. يتم تسجيله بواسطة Plugin xai المضمّن (ضمن عقد tools) ويرسل الطلبات إلى نقطة النهاية نفسها https://api.x.ai/v1/responses التي يستخدمها x_search.
الخاصيةالقيمة
اسم الأداةcode_execution
Plugin المزوّدxai (مضمّن، enabledByDefault: true)
المصادقةملف مصادقة xAI، أو XAI_API_KEY، أو plugins.entries.xai.config.webSearch.apiKey
النموذج الافتراضيgrok-4-1-fast
المهلة الافتراضية30 ثانية
maxTurns الافتراضيغير مضبوط (تطبّق xAI حدّها الداخلي الخاص)
يختلف هذا عن exec المحلي:
  • يشغّل exec أوامر shell على جهازك أو على عقدة مقترنة.
  • يشغّل code_execution لغة Python في sandbox بعيد خاص بـ xAI.
استخدم code_execution من أجل:
  • الحسابات.
  • الجداول.
  • الإحصاءات السريعة.
  • التحليل بأسلوب المخططات.
  • تحليل البيانات التي يعيدها x_search أو web_search.
لا تستخدمه عندما تحتاج إلى ملفات محلية، أو shell الخاص بك، أو المستودع، أو أجهزة مقترنة. استخدم exec لذلك.

​
الإعداد

1

Provide xAI credentials

سجّل الدخول باستخدام Grok OAuth عبر اشتراك SuperGrok أو X Premium مؤهل، أو خزّن مفتاح API. يستخدم xAI OAuth التحقق برمز الجهاز، لذلك يعمل من المضيفات البعيدة دون استدعاء localhost. يعمل OAuth مع code_execution وx_search؛ ويمكن أيضاً لـ XAI_API_KEY أو إعداد web-search في Plugin تشغيل Grok web_search.
openclaw models auth login --provider xai --method oauth
أثناء التثبيت الجديد، تتوفر خيارات المصادقة نفسها داخل التهيئة الأولية:
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
أو استخدم مفتاح API:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
أو عبر الإعدادات:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Enable and tune code_execution

يتوفر code_execution عندما تكون بيانات اعتماد xAI متاحة. اضبط plugins.entries.xai.config.codeExecution.enabled على false لتعطيله، أو استخدم الكتلة نفسها لضبط النموذج والمهلة.
{
  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)
          },
        },
      },
    },
  },
}
3

Restart the Gateway

openclaw gateway restart
يظهر code_execution في قائمة أدوات الوكيل بمجرد أن يعيد Plugin xai التسجيل مع enabled: true.

​
كيفية استخدامه

اطلب بشكل طبيعي واجعل نية التحليل صريحة: 
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 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، وليس تنفيذ عملية محلية.
  • تعامل مع النتائج كتحليل عابر، وليس كجلسة دفتر ملاحظات دائمة.
  • لا تفترض الوصول إلى الملفات المحلية أو مساحة عملك.
  • للحصول على بيانات X حديثة، استخدم x_search أولاً ومرّر النتيجة إلى code_execution.

​
ذات صلة

Exec tool

تنفيذ shell محلي على جهازك أو عقدة مقترنة.

Exec approvals

سياسة السماح/الرفض لتنفيذ shell.

Web tools

web_search وx_search وweb_fetch.

xAI provider

نماذج Grok، وبحث الويب/X، وإعدادات تنفيذ الكود.