Tools
تنفيذ التعليمات البرمجية
يشغّل code_execution تحليل Python بعيدًا ومعزولًا على Responses API من xAI
(https://api.x.ai/v1/responses، وهي نقطة النهاية نفسها التي يستخدمها x_search). وتُسجّله
إضافة xai المضمّنة ضمن عقد tools.
| الخاصية | القيمة |
|---|---|
| اسم الأداة | 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-keyexport 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"}