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

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

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

• يشغّل exec أوامر shell على جهازك أو على عقدة مقترنة.
• يشغّل 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، لذلك ينبغي أن يرسل الوكيل طلب التحليل كاملاً وأي بيانات مضمنة في مطالبة واحدة.

الأخطاء

عند تشغيل الأداة دون مصادقة، تُرجع خطأ 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.

ذات صلة