xAI

يفضّل موفّر بحث الويب grok المضمّن OAuth الخاص بـ xAI، ثم يعود احتياطيًا إلى XAI_API_KEY أو مفتاح بحث ويب خاص بالمكوّن الإضافي:

openclaw models auth login --provider xai --method oauthopenclaw config set tools.web.search.provider grok

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

• النموذج الافتراضي: xai/grok-imagine-video
• نموذج إضافي: xai/grok-imagine-video-1.5
• الأوضاع الكلاسيكية: تحويل النص إلى فيديو، وتحويل الصورة إلى فيديو، والتوليد من صورة مرجعية، وتحرير فيديو بعيد، وتمديد فيديو بعيد
• وضع Video 1.5: تحويل الصورة إلى فيديو فقط، باستخدام صورة واحدة بالضبط للإطار الأول
• نسب العرض إلى الارتفاع: 1:1، 16:9، 9:16، 4:3، 3:4، 3:2، 2:3؛ يرث تحويل الصورة إلى فيديو في الوضع الكلاسيكي وVideo 1.5 نسبة الصورة المصدر عند حذفها
• درجات الدقة: الوضع الكلاسيكي 480P/720P؛ ويدعم Video 1.5 أيضًا 1080P؛ وتكون القيمة الافتراضية لجميع أوضاع التوليد 480P
• المدة: من 1 إلى 15 ثانية للتوليد/تحويل الصورة إلى فيديو، ومن 1 إلى 10 ثوانٍ عند استخدام أدوار reference_image الكلاسيكية، ومن 2 إلى 10 ثوانٍ للتمديد الكلاسيكي
• التوليد من صورة مرجعية: عيّن imageRoles إلى reference_image لكل صورة مقدّمة؛ تقبل xAI ما يصل إلى 7 صور من هذا النوع
• يرث تحرير/تمديد الفيديو نسبة العرض إلى الارتفاع ودقة الفيديو المُدخل؛ ولا تقبل هذه العمليات تجاوز إعدادات الأبعاد
• المهلة الافتراضية للعملية: 600 ثانية ما لم يُعيّن video_generate.timeoutMs أو agents.defaults.videoGenerationModel.timeoutMs

يتعرف Video 1.5 أيضًا على معرّفَي xAI وهما grok-imagine-video-1.5-preview وgrok-imagine-video-1.5-2026-05-30. يمرّر OpenClaw المعرّف المحدد دون تغيير، لكنه يطبق التحقق نفسه الذي يسمح بالصور فقط.

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

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

يسجّل المكوّن الإضافي xai المضمّن توليد الصور من خلال أداة image_generate المشتركة.

• نموذج الصور الافتراضي: xai/grok-imagine-image
• نموذج إضافي: xai/grok-imagine-image-quality
• الأوضاع: تحويل النص إلى صورة وتحرير الصورة المرجعية
• المدخلات المرجعية: حقل image واحد أو ما يصل إلى ثلاثة حقول images
• نسب العرض إلى الارتفاع: 1:1، 16:9، 9:16، 4:3، 3:4، 3:2، 2:3، 2:1، 1:2، 19.5:9، 9:19.5، 20:9، 9:20
• درجات الدقة: 1K، 2K
• العدد: ما يصل إلى 4 صور
• المهلة الافتراضية للعملية: 600 ثانية ما لم يُضبط image_generate.timeoutMs أو agents.defaults.imageGenerationModel.timeoutMs

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

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

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

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

• الأصوات: كتالوج مباشر موثّق من xAI؛ اعرضه باستخدام openclaw infer tts voices --provider xai
• أصوات الرجوع الاحتياطي دون اتصال: ara، eve، leo، rex، sal
• الصوت الافتراضي: eve
• تُمرّر معرّفات الأصوات المخصّصة للحساب حتى إن لم تكن موجودة في استجابة الكتالوج المضمّن
• التنسيقات: mp3، wav، pcm، mulaw، alaw
• اللغة: رمز BCP-47 أو auto
• السرعة: تجاوز أصلي للسرعة لدى الموفّر
• تنسيق ملاحظات Opus الصوتية الأصلي غير مدعوم

لاستخدام xAI بوصفه موفّر TTS الافتراضي:

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

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

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

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

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",          },        ],      },    },  },}

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

يسجّل Plugin xai المضمّن أيضًا موفّر نسخ في الوقت الفعلي لصوت المكالمات الصوتية المباشرة.

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

يرسل تدفق وسائط Twilio الخاص بـ Voice Call إطارات صوت G.711 mu-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.3",            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.3",          },        },      },    },  },}

• يمكن لمصادقة xAI استخدام مفتاح API أو متغير بيئة أو رجوع احتياطي إلى إعداد Plugin أو OAuth مع حساب xAI مؤهّل. يستخدم OAuth التحقق برمز الجهاز من دون استدعاء عكسي إلى localhost. تحدد xAI الحسابات التي يمكنها تلقي رموز OAuth لواجهة API، وقد تعرض صفحة الموافقة Grok Build رغم أن OpenClaw لا يتطلب تطبيق Grok Build.
• لا يوفّر OpenClaw حاليًا عائلة نماذج الوكلاء المتعددين من xAI. تقدّم xAI هذه النماذج عبر واجهة Responses API، لكنها لا تقبل أدوات جهة العميل أو الأدوات المخصّصة التي تستخدمها حلقة الوكيل المشتركة في OpenClaw. راجع قيود الوكلاء المتعددين في xAI.
• لم يُسجّل صوت xAI Realtime بعد بوصفه موفّرًا في OpenClaw. فهو يحتاج إلى عقد جلسة صوتية ثنائية الاتجاه يختلف عن STT الدفعي أو النسخ المتدفق.
• لا تتوفر quality للصور وmask للصور ونسبة العرض إلى الارتفاع الأصلية auto في xAI حتى تحتوي أداة image_generate المشتركة على عناصر تحكم مقابلة مشتركة بين الموفّرين.

• يطبّق OpenClaw تلقائيًا إصلاحات التوافق الخاصة بـ xAI لمخطط الأدوات واستدعاءات الأدوات ضمن مسار المشغّل المشترك.
• تستخدم طلبات xAI الأصلية القيمة tool_stream: true افتراضيًا. اضبط agents.defaults.models["xai/<model>"].params.tool_stream على false لتعطيلها.
• يزيل غلاف xAI المضمّن حدود عدد الاحتواء غير المدعومة في المخطط ومفاتيح حمولة جهد الاستدلال غير المدعومة قبل إرسال طلبات xAI الأصلية. يدعم Grok 4.5 الجهد المنخفض والمتوسط والعالي (الافتراضي: عالٍ). يدعم Grok 4.3 عدم استخدام الجهد والجهد المنخفض والمتوسط والعالي (الافتراضي: منخفض). لا تتيح نماذج xAI الأخرى القادرة على الاستدلال التحكم في الجهد القابل للإعداد، لكنها تظل تطلب include: ["reasoning.encrypted_content"] كي يمكن إعادة تشغيل الاستدلال المشفّر السابق في الجولات اللاحقة.
• تتوفر web_search وx_search وcode_execution كأدوات OpenClaw. يرفق OpenClaw بكل طلب أداة الوظيفة المضمّنة المحددة من xAI التي تحتاجها تلك الأداة فقط، بدلًا من إرفاق كل الأدوات الأصلية بكل جولة محادثة.
• يقرأ web_search في Grok القيمة 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 المحلي.