xAI

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

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

يسجّل Plugin ‏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",      },    },  },}

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

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

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

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

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

• نقطة النهاية: WebSocket ‏wss://api.x.ai/v1/stt لدى xAI
• الترميز الافتراضي: 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 المضمّن جلسات Grok Voice Agent في الوقت الفعلي لوضع Talk من خلال عقد registerRealtimeVoiceProvider المشترك.

• نقطة النهاية: wss://api.x.ai/v1/realtime?model=<voice-model>
• النموذج الافتراضي: grok-voice-latest
• الصوت الافتراضي: eve
• النقل: gateway-relay (مسارات ترحيل iOS وAndroid وControl UI)
• الصوت: PCM16 بتردد 24 kHz أو G.711 µ-law بتردد 8 kHz
• المقاطعة: يقاطع VAD في خادم xAI الاستجابة؛ ويمسح OpenClaw التشغيل المصطف ويقتطع سجل الموفّر الذي لم يُشغّل

اضبط Talk على Gateway:

{  talk: {    realtime: {      provider: "xai",      mode: "realtime",      transport: "gateway-relay",      brain: "agent-consult",      providers: {        xai: {          model: "grok-voice-latest",          voice: "eve",          // اشترك فقط إذا كانت إعادة تشغيل الجلسة من جانب الموفّر مقبولة.          sessionResumption: false,        },      },    },  },  env: { XAI_API_KEY: "xai-..." },}

تُحل أيضًا الإعدادات التي يملكها الموفّر من plugins.entries.voice-call.config.realtime.providers.xai عندما تعيد Voice Call أو محددات الوقت الفعلي المشتركة استخدام خريطة الموفّر نفسها. المفاتيح المدعومة هي apiKey وbaseUrl وmodel وvoice وvadThreshold وsilenceDurationMs، وprefixPaddingMs وreasoningEffort وsessionResumption. يقبل reasoningEffort فقط high أو none، بما يتوافق مع واجهة xAI Voice Agent API.

ينشئ VAD في خادم xAI الاستجابات دائمًا ويتعامل مع مقاطعة الصوت. استخدم consultRouting: "provider-direct"؛ ولا يدعم بروتوكول xAI Voice Agent توجيه النص الإجباري أو تعطيل مقاطعة صوت الإدخال.

يعرض 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 الحسابات التي يمكنها تلقي رموز API مميزة عبر OAuth، وقد تعرض صفحة الموافقة Grok Build رغم أن OpenClaw لا يتطلب تطبيق Grok Build.
• لا يتيح OpenClaw حاليًا عائلة نماذج xAI متعددة الوكلاء. تقدم xAI هذه النماذج عبر Responses API، لكنها لا تقبل الأدوات المخصصة أو الأدوات من جانب العميل التي تستخدمها حلقة الوكيل المشتركة في OpenClaw. راجع قيود xAI متعددة الوكلاء.
• يتيح الصوت الفوري من xAI حاليًا نقل Talk عبر ترحيل Gateway فقط. ولم تُوصّل بعد جلسات WebSocket الخاصة بالموفر والتي يديرها المتصفح في واجهة التحكم.
• لا تُتاح صورة xAI ‏quality، وصورة mask، ونسب الأبعاد الإضافية الأصلية فقط حتى تتوفر في أداة 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 المضمّنة المحددة التي تحتاج إليها تلك الأداة، بدلًا من إرفاق كل الأدوات الأصلية بكل تفاعل محادثة.
• يقرأ Grok ‏web_search من plugins.entries.xai.config.webSearch.baseUrl. ويقرأ x_search من plugins.entries.xai.config.xSearch.baseUrl، ثم يرجع إلى عنوان URL الأساسي للبحث على الويب في Grok كخيار احتياطي.
• تكون ملكية x_search وcode_execution لـ Plugin ‏xAI المضمّن بدلًا من ترميزهما مباشرة في وقت تشغيل النموذج الأساسي.
• يمثل code_execution تنفيذًا عن بُعد في بيئة xAI المعزولة، وليس exec محليًا.