xAI

يمكن لمزوّد بحث الويب grok المضمّن استخدام XAI_API_KEY أو مفتاح بحث ويب خاص بـ Plugin:

openclaw config set tools.web.search.provider grok

يسجّل Plugin xai المضمّن توليد الفيديو عبر أداة video_generate المشتركة.

• نموذج الفيديو الافتراضي: xai/grok-imagine-video
• الأوضاع: نص إلى فيديو، صورة إلى فيديو، توليد صورة مرجعية، تعديل فيديو بعيد، وتمديد فيديو بعيد
• نسب العرض إلى الارتفاع: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• الدقات: 480P, 720P
• المدة: 1-15 ثانية للتوليد/الصورة إلى فيديو، و1-10 ثوانٍ عند استخدام أدوار reference_image، و2-10 ثوانٍ للتمديد
• توليد الصور المرجعية: عيّن imageRoles إلى reference_image لكل صورة مقدّمة؛ تقبل xAI ما يصل إلى 7 صور من هذا النوع

لاستخدام xAI كمزوّد الفيديو الافتراضي:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "xai/grok-imagine-video",      },    },  },}

يسجّل Plugin xai المضمّن توليد الصور عبر أداة image_generate المشتركة.

• نموذج الصور الافتراضي: xai/grok-imagine-image
• نموذج إضافي: xai/grok-imagine-image-pro
• الأوضاع: نص إلى صورة وتعديل صورة مرجعية
• المدخلات المرجعية: image واحدة أو ما يصل إلى خمس images
• نسب العرض إلى الارتفاع: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• الدقات: 1K, 2K
• العدد: ما يصل إلى 4 صور

يطلب OpenClaw من xAI استجابات صور b64_json حتى يمكن تخزين الوسائط المُولّدة وتسليمها عبر مسار مرفقات القناة المعتاد. تُحوّل الصور المرجعية المحلية إلى عناوين URL بيانات؛ وتُمرّر مراجع http(s) البعيدة كما هي.

لاستخدام xAI كمزوّد الصور الافتراضي:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

يسجّل Plugin xai المضمّن تحويل النص إلى كلام عبر سطح مزوّد tts المشترك.

• الأصوات: eve, ara, rex, sal, leo, una
• الصوت الافتراضي: eve
• الصيغ: mp3, wav, pcm, mulaw, alaw
• اللغة: رمز BCP-47 أو auto
• السرعة: تجاوز سرعة أصلي للمزوّد
• صيغة ملاحظات Opus الصوتية الأصلية غير مدعومة

لاستخدام xAI كمزوّد TTS الافتراضي:

{  messages: {    tts: {      provider: "xai",      providers: {        xai: {          voiceId: "eve",        },      },    },  },}

يسجّل Plugin xai المضمّن تحويل الكلام إلى نص دفعي عبر سطح نسخ فهم الوسائط في OpenClaw.

• النموذج الافتراضي: grok-stt
• نقطة النهاية: xAI REST /v1/stt
• مسار الإدخال: رفع ملف صوتي متعدد الأجزاء
• مدعوم في OpenClaw حيثما يستخدم نسخ الصوت الوارد tools.media.audio، بما في ذلك مقاطع قنوات Discord الصوتية ومرفقات الصوت في القنوات

لفرض xAI لنسخ الصوت الوارد:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

يمكن توفير اللغة عبر إعداد وسائط الصوت المشترك أو طلب نسخ لكل استدعاء. تُقبل تلميحات الموجّه بواسطة سطح OpenClaw المشترك، لكن تكامل xAI REST STT لا يمرّر إلا الملف والنموذج واللغة لأنها تطابق نقطة نهاية xAI العامة الحالية بوضوح.

يسجّل Plugin xai المضمّن أيضاً مزوّد نسخ في الوقت الفعلي لصوت مكالمات الصوت الحية.

• نقطة النهاية: xAI WebSocket wss://api.x.ai/v1/stt
• الترميز الافتراضي: mulaw
• معدل العينة الافتراضي: 8000
• تحديد نقطة النهاية الافتراضي: 800ms
• النصوص المؤقتة: مفعّلة افتراضياً

يرسل تدفق وسائط Twilio في Voice Call إطارات صوت G.711 µ-law، لذلك يمكن لمزوّد xAI تمرير تلك الإطارات مباشرة دون تحويل ترميز:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

توجد الإعدادات التي يملكها المزوّد ضمن plugins.entries.voice-call.config.streaming.providers.xai. المفاتيح المدعومة هي apiKey وbaseUrl وsampleRate وencoding (pcm أو mulaw أو alaw) وinterimResults وendpointingMs وlanguage.

يوفّر Plugin المضمّن الخاص بـ xAI الأداة x_search كأداة OpenClaw للبحث في محتوى X (المعروف سابقًا باسم Twitter) عبر Grok.

مسار الإعدادات: plugins.entries.xai.config.xSearch

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

يوفّر Plugin المضمّن الخاص بـ xAI الأداة code_execution كأداة OpenClaw لتنفيذ التعليمات البرمجية عن بُعد في بيئة عزل xAI.

مسار الإعدادات: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• المصادقة اليوم عبر مفتاح API فقط. يمكن تخزين مفتاح API في ملف تعريف مصادقة xAI أو متغير بيئة أو إعدادات Plugin؛ لا يوجد حتى الآن تدفق xAI OAuth أو رمز جهاز في OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 غير مدعوم على مسار مزوّد xAI العادي لأنه يتطلب سطح API علويًا مختلفًا عن نقل xAI القياسي في OpenClaw.
• لم يُسجّل صوت xAI Realtime كمزوّد OpenClaw حتى الآن. يحتاج إلى عقد جلسة صوتية ثنائية الاتجاه يختلف عن STT الدفعي أو النسخ بالبث.
• لا تُعرَض quality الخاصة بصور xAI، وmask الخاص بالصور، ونِسب الأبعاد الأصلية الإضافية الحصرية، إلى أن تتوفر لأداة image_generate المشتركة عناصر تحكم مقابلة عابرة للمزوّدين.

• يطبّق OpenClaw تلقائيًا إصلاحات توافق مخطط الأدوات واستدعاءات الأدوات الخاصة بـ xAI على مسار المشغّل المشترك.
• تستخدم طلبات xAI الأصلية افتراضيًا tool_stream: true. اضبط agents.defaults.models["xai/<model>"].params.tool_stream على false لتعطيله.
• يزيل الغلاف المضمّن الخاص بـ xAI أعلام مخطط الأدوات الصارمة غير المدعومة ومفاتيح حمولة الاستدلال قبل إرسال طلبات xAI الأصلية.
• تُعرَض web_search وx_search وcode_execution كأدوات OpenClaw. يفعّل OpenClaw الميزة المضمّنة المحددة من xAI التي يحتاجها داخل كل طلب أداة بدلًا من إرفاق كل الأدوات الأصلية بكل دور دردشة.
• يقرأ Grok web_search القيمة plugins.entries.xai.config.webSearch.baseUrl. يقرأ x_search القيمة plugins.entries.xai.config.xSearch.baseUrl، ثم يعود احتياطيًا إلى عنوان URL الأساسي لبحث الويب في Grok.
• يملك Plugin xAI المضمّن x_search وcode_execution بدلًا من ترميزهما مباشرة في وقت تشغيل النموذج الأساسي.
• code_execution هو تنفيذ في بيئة عزل xAI عن بُعد، وليس exec المحلي.