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
• الأوضاع: تحويل النص إلى فيديو، تحويل الصورة إلى فيديو، توليد بصورة مرجعية، تحرير فيديو بعيد، وتمديد فيديو بعيد
• نسب العرض إلى الارتفاع: 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 صور من هذا النوع
• مهلة العملية الافتراضية: 600 ثانية ما لم يتم ضبط video_generate.timeoutMs أو agents.defaults.videoGenerationModel.timeoutMs

لاستخدام 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, 2:3, 3:2
• الدقات: 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 المشترك.

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

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

{  messages: {    tts: {      provider: "xai",      providers: {        xai: {          speakerVoiceId: "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 لتنفيذ التعليمات البرمجية عن بُعد في بيئة sandbox الخاصة بـ xAI.

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

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

• يمكن لمصادقة 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 للصور ونسب الأبعاد الإضافية الأصلية فقط في xAI حتى تمتلك أداة image_generate المشتركة عناصر تحكم مقابلة عابرة للموفرين.

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