تنفيذ التعليمات البرمجية

code_execution يشغّل تحليل Python عن بُعد داخل صندوق حماية على واجهة Responses API الخاصة بـ xAI. يتم تسجيله بواسطة Plugin xai المضمّن (ضمن عقد tools) ويوجّه الطلبات إلى نقطة النهاية نفسها https://api.x.ai/v1/responses التي يستخدمها x_search.

يختلف هذا عن exec المحلي:

• يشغّل exec أوامر shell على جهازك أو Node مقترن.
• يشغّل code_execution Python في صندوق الحماية البعيد الخاص بـ xAI.

استخدم code_execution من أجل:

• الحسابات.
• الجدولة.
• الإحصاءات السريعة.
• التحليل بنمط المخططات.
• تحليل البيانات التي يُرجعها x_search أو web_search.

لا تستخدمه عندما تحتاج إلى ملفات محلية، أو shell الخاص بك، أو مستودعك، أو أجهزة مقترنة. استخدم 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. 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.

ذو صلة