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

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

يعمل code_execution على خوادم xAI. تفرض xAI رسومًا قدرها 5 دولارات لكل 1,000 استدعاء للأداة، بالإضافة إلى رموز الإدخال والإخراج الخاصة بالنموذج.

الخاصية	القيمة
اسم الأداة	`code_execution`
إضافة المزوّد	`xai` (مضمّنة، `enabledByDefault: true`)
المصادقة	ملف مصادقة xAI، أو `XAI_API_KEY`، أو `plugins.entries.xai.config.webSearch.apiKey`
النموذج الافتراضي	`grok-4.3`
المهلة الافتراضية	30 ثانية
`maxTurns` الافتراضي	غير معيّن (تطبّق xAI حدها الداخلي الخاص)

استخدمه لإجراء الحسابات، وإنشاء الجداول، والإحصاءات السريعة، والتحليلات الشبيهة بالمخططات، بما في ذلك تحليل البيانات التي يعيدها x_search أو web_search. ولا يمكنه الوصول إلى الملفات المحلية أو الصدفة أو المستودع أو الأجهزة المقترنة، كما أنه لا يحتفظ بالحالة بين الاستدعاءات، لذا تعامل مع كل استدعاء بوصفه تحليلًا مؤقتًا، لا جلسة دفتر ملاحظات. للحصول على بيانات X حديثة، شغّل x_search أولًا ومرّر النتيجة إليه. للتنفيذ المحلي، استخدم exec بدلًا منه.

الإعداد

توفير بيانات اعتماد xAI

تتطلب OAuth اشتراكًا مؤهلًا في SuperGrok أو X Premium (مع التحقق باستخدام رمز الجهاز، لذا تعمل من المضيفات البعيدة من دون رد اتصال عبر المضيف المحلي):

openclaw models auth login --provider xai --method oauth

أثناء التثبيت الجديد، يتوفر الخيار نفسه في الإعداد الأولي:

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-...",
          },
        },
      },
    },
  },
}

يتيح أي من هذه الخيارات الثلاثة أيضًا تشغيل x_search وweb_search في Grok.

تمكين code_execution وضبطه

عند حذف enabled، لا تُعرض code_execution إلا عندما يكون مزوّد النموذج النشط هو xai ويمكن العثور على بيانات اعتماد xAI. بالنسبة إلى نموذج نشط مزوّده المعروف ليس xAI، اضبط plugins.entries.xai.config.codeExecution.enabled على true للاشتراك في الاستخدام عبر المزوّدين. إذا كان مزوّد النموذج النشط مفقودًا أو تعذّر تحديده، تظل الأداة مخفية. اضبط enabled على false لتعطيلها لدى جميع المزوّدين. وتظل بيانات اعتماد xAI مطلوبة دائمًا.استخدم الكتلة نفسها لتجاوز النموذج أو الحد الأقصى للدورات أو المهلة:

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true, // مطلوب لمزوّد نموذج معروف ليس xAI
            model: "grok-4.3", // تجاوز نموذج تنفيذ التعليمات البرمجية الافتراضي من xAI
            maxTurns: 2,            // حد اختياري لدورات الأداة الداخلية
            timeoutSeconds: 30,     // مهلة الطلب (الافتراضي: 30)
          },
        },
      },
    },
  },
}

إعادة تشغيل Gateway

openclaw gateway restart

تظهر code_execution في قائمة أدوات الوكيل بمجرد أن تعيد إضافة xAI تسجيلها وتنجح عمليات التحقق من المزوّد والتمكين والمصادقة أعلاه.

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

وضّح هدف التحليل صراحةً؛ تأخذ الأداة معامل task واحدًا، لذا أرسل الطلب الكامل وأي بيانات مضمنة في موجّه واحد:

استخدم code_execution لحساب المتوسط المتحرك لمدة 7 أيام لهذه الأرقام: ...

استخدم x_search للعثور على المنشورات التي تذكر OpenClaw هذا الأسبوع، ثم استخدم code_execution لحساب عددها حسب اليوم.

استخدم web_search لجمع أحدث أرقام معايير أداء الذكاء الاصطناعي، ثم استخدم code_execution لمقارنة التغيّرات المئوية.

الأخطاء

من دون مصادقة، تعيد الأداة خطأ JSON منظمًا (وليس استثناءً مُلقى)، بحيث يستطيع الوكيل تصحيح الخطأ ذاتيًا:

{
  "error": "missing_xai_api_key",
  "message": "تحتاج code_execution إلى بيانات اعتماد xAI. شغّل `openclaw onboard --auth-choice xai-oauth` لتسجيل الدخول باستخدام Grok، أو شغّل `openclaw onboard --auth-choice xai-api-key`، أو اضبط `XAI_API_KEY` في بيئة Gateway، أو اضبط `plugins.entries.xai.config.webSearch.apiKey`.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

ذو صلة

أداة Exec

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

موافقات Exec

سياسة السماح أو الرفض لتنفيذ الصدفة.

أدوات الويب

web_search وx_search وweb_fetch.

مزوّد xAI

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

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

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

الإعداد

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

الأخطاء

ذو صلة

أداة Exec

موافقات Exec

أدوات الويب

مزوّد xAI

​الإعداد

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

​الأخطاء

​ذو صلة

أداة Exec

موافقات Exec

أدوات الويب

مزوّد xAI

الإعداد

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

الأخطاء

ذو صلة