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

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

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

• يشغّل exec أوامر shell على جهازك أو العقدة المقترنة.
• يشغّل 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. 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.

# ذو صلة