الانتقال إلى المحتوى الرئيسي
OpenClaw يشحن Plugin موفّر xai مضمّناً لنماذج Grok. بالنسبة لمعظم المستخدمين، المسار الموصى به هو OAuth الخاص بـ Grok مع اشتراك SuperGrok أو X Premium مؤهل. يظل OpenClaw محلياً أولاً: يعمل Gateway والإعداد والتوجيه والأدوات على جهازك، بينما تتم مصادقة طلبات نموذج Grok عبر xAI وتُرسل إلى API الخاصة بـ xAI. لا يتطلب OAuth مفتاح API من xAI، ولا يتطلب تطبيق Grok Build. قد تظل xAI تعرض Grok Build على شاشة الموافقة لأن OpenClaw يستخدم عميل OAuth المشترك لدى xAI.

​
اختر مسار الإعداد

استخدم المسار الذي يطابق حالة تثبيت OpenClaw لديك:
1

تثبيت OpenClaw جديد

شغّل الإعداد الأولي مع تثبيت الخادم الخفي عندما تجهّز Gateway محلياً جديداً، ثم اختر خيار OAuth الخاص بـ xAI/Grok في خطوة النموذج/المصادقة:
openclaw onboard --install-daemon
على VPS أو عبر SSH، اختر xAI OAuth مباشرة؛ يستخدم OpenClaw التحقق برمز الجهاز ولا يتطلب رد نداء إلى localhost:
openclaw onboard --install-daemon --auth-choice xai-oauth
لا يتطلب OAuth مفتاح API من xAI. لا يتطلب OpenClaw تطبيق Grok Build. قد تظل xAI تسمّي تطبيق الموافقة Grok Build لأن OpenClaw يستخدم عميل OAuth المشترك لدى xAI.
2

تثبيت OpenClaw موجود

إذا كان OpenClaw مضبوطاً بالفعل، فسجّل الدخول إلى xAI فقط. لا تُعِد تشغيل الإعداد الأولي الكامل أو إعادة تثبيت الخادم الخفي لمجرد توصيل Grok:
openclaw models auth login --provider xai --method oauth
لجعل Grok النموذج الافتراضي بعد تسجيل الدخول، طبّقه بشكل منفصل:
openclaw models set xai/grok-4.3
أعد تشغيل الإعداد الأولي الكامل فقط إذا كنت تريد عمداً تغيير Gateway أو الخادم الخفي أو القناة أو مساحة العمل أو خيارات إعداد أخرى.
3

مسار مفتاح API

لا يزال إعداد مفتاح API يعمل مع مفاتيح xAI Console ولأسطح الوسائط التي تتطلب إعداد موفّر مدعوماً بمفتاح:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
4

اختر نموذجاً

{
  agents: { defaults: { model: { primary: "xai/grok-4.3" } } },
}
يستخدم OpenClaw واجهة xAI Responses API بوصفها نقل xAI المضمّن. يمكن للاعتماد نفسه من openclaw models auth login --provider xai --method oauth أو openclaw models auth login --provider xai --method api-key أيضاً تشغيل web_search وx_search وcode_execution البعيد وتوليد الصور/الفيديو من xAI كدعم من الدرجة الأولى. يتطلب الكلام والنسخ حالياً XAI_API_KEY أو إعداد الموفّر. يفضّل web_search المدعوم بـ Grok استخدام xAI OAuth، ويرجع إلى XAI_API_KEY أو إعداد بحث الويب في Plugin. إذا خزّنت مفتاح xAI تحت plugins.entries.xai.config.webSearch.apiKey، فإن موفّر نموذج xAI المضمّن يعيد استخدام ذلك المفتاح كخيار رجوع أيضاً. اضبط plugins.entries.xai.config.webSearch.baseUrl لتوجيه web_search الخاص بـ Grok وبشكل افتراضي x_search عبر وكيل xAI Responses تابع للمشغّل. توجد إعدادات ضبط code_execution تحت plugins.entries.xai.config.codeExecution.

​
استكشاف أخطاء OAuth وإصلاحها

  • بالنسبة إلى SSH أو Docker أو VPS أو الإعدادات البعيدة الأخرى، استخدم openclaw models auth login --provider xai --method oauth؛ يستخدم xAI OAuth التحقق برمز الجهاز بدلاً من رد نداء إلى localhost.
  • إذا نجح تسجيل الدخول لكن Grok ليس النموذج الافتراضي، شغّل openclaw models set xai/grok-4.3.
  • لفحص ملفات تعريف مصادقة xAI المحفوظة، شغّل: 
    openclaw models auth list --provider xai
openclaw models status
  • تحدد xAI الحسابات التي يمكنها تلقي رموز API عبر OAuth. إذا لم يكن الحساب مؤهلاً، فجرّب مسار مفتاح API أو تحقق من الاشتراك من جهة xAI.
استخدم xai-oauth عند تسجيل الدخول من SSH أو Docker أو VPS. يطبع OpenClaw عنوان URL من xAI ورمزاً قصيراً؛ أكمل تسجيل الدخول في أي متصفح محلي بينما تستطلع العملية البعيدة xAI لاكتمال تبادل الرمز.

​
الفهرس المضمّن

يتضمن OpenClaw نماذج محادثة xAI الحالية مباشرة، مرتبة من الأحدث أولاً في أدوات اختيار النماذج:
العائلةمعرّفات النماذج
Grok Build 0.1grok-build-0.1
Grok 4.3grok-4.3
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
لا يزال Plugin يحلّ موجهاً أسماء Grok 3 وGrok 4 وGrok 4 Fast وGrok 4.1 Fast وGrok Code الأقدم للإعدادات الموجودة. تُطبّع الأسماء البديلة الرسمية لـ Grok Code Fast إلى grok-build-0.1؛ لم يعد OpenClaw يعرض أسماء upstream الأخرى المتقاعدة في الفهرس القابل للاختيار.
استخدم grok-4.3 للمحادثة العامة وgrok-build-0.1 لأعباء العمل المركّزة على البناء/الترميز ما لم تكن تحتاج صراحة إلى اسم بديل تجريبي لـ Grok 4.20.

​
تغطية ميزات OpenClaw

يربط Plugin المضمّن سطح API العام الحالي لـ xAI بعقود الموفّر والأدوات المشتركة في OpenClaw. القدرات التي لا تلائم العقد المشترك (مثل TTS المتدفق والصوت الفوري) غير مكشوفة - انظر الجدول أدناه.
قدرة xAIسطح OpenClawالحالة
المحادثة / Responsesموفّر نموذج xai/<model>نعم
بحث الويب من جهة الخادمموفّر web_search باسم grokنعم
بحث X من جهة الخادمأداة x_searchنعم
تنفيذ الكود من جهة الخادمأداة code_executionنعم
الصورimage_generateنعم
الفيديوهاتvideo_generateنعم
تحويل النص إلى كلام دفعيmessages.tts.provider: "xai" / ttsنعم
TTS المتدفق-غير مكشوف؛ يعيد عقد TTS في OpenClaw مخازن صوتية كاملة
تحويل الكلام إلى نص دفعيtools.media.audio / فهم الوسائطنعم
تحويل الكلام إلى نص متدفقVoice Call streaming.provider: "xai"نعم
الصوت الفوري-غير مكشوف بعد؛ عقد جلسة/WebSocket مختلف
الملفات / الدفعاتتوافق API النموذج العام فقطليست أداة OpenClaw من الدرجة الأولى
يستخدم OpenClaw واجهات REST من xAI للصور/الفيديو/TTS/STT لتوليد الوسائط والكلام والنسخ الدفعي، وWebSocket STT المتدفق من xAI لنسخ المكالمات الصوتية الحية، وResponses API لأدوات النموذج والبحث وتنفيذ الكود. الميزات التي تحتاج إلى عقود OpenClaw مختلفة، مثل جلسات الصوت الفورية، موثقة هنا بوصفها قدرات upstream بدلاً من سلوك Plugin مخفي.

​
تعيينات الوضع السريع

يعيد /fast on أو agents.defaults.models["xai/<model>"].params.fastMode: true كتابة طلبات xAI الأصلية كما يلي:
النموذج المصدرهدف الوضع السريع
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
أسماء التوافق القديمة البديلة

لا تزال الأسماء البديلة القديمة تُطبّع إلى المعرّفات المضمّنة القياسية:
الاسم البديل القديمالمعرّف القياسي
grok-code-fast-1grok-build-0.1
grok-code-fastgrok-build-0.1
grok-code-fast-1-0825grok-build-0.1
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
الميزات

يفضّل موفّر بحث الويب grok المضمّن xAI OAuth، ثم يرجع إلى XAI_API_KEY أو مفتاح بحث ويب خاص بـ Plugin:
openclaw models auth login --provider xai --method oauth
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 صور من هذا النوع
  • مهلة العملية الافتراضية: 600 ثانية ما لم يتم ضبط video_generate.timeoutMs أو agents.defaults.videoGenerationModel.timeoutMs
لا تُقبل مخازن الفيديو المحلية. استخدم عناوين URL بعيدة بصيغة http(s) لمدخلات تحرير/تمديد الفيديو. يقبل تحويل الصورة إلى فيديو مخازن الصور المحلية لأن OpenClaw يستطيع ترميزها كعناوين URL بيانات لـ xAI.
لاستخدام 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",
      },
    },
  },
}
توثق xAI أيضًا quality وmask وuser ونسبًا أصلية إضافية مثل 1:2 و2:1 و9:20 و20:9. يمرر OpenClaw حاليًا عناصر التحكم المشتركة بين الموفرين للصور فقط؛ ولا تُكشف عناصر التحكم الأصلية غير المدعومة عمدًا عبر image_generate.
يسجل 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",
        },
      },
    },
  },
}
يستخدم OpenClaw نقطة نهاية الدُفعات /v1/tts من xAI. توفر xAI أيضًا TTS متدفقًا عبر WebSocket، لكن عقد موفر الكلام في OpenClaw يتوقع حاليًا مخزنًا صوتيًا مكتملًا قبل تسليم الرد.
يسجل 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.
هذا الموفر المتدفق مخصص لمسار التفريغ النصي الآني في Voice Call. يسجل Discord الصوت حاليًا في مقاطع قصيرة ويستخدم بدلًا من ذلك مسار التفريغ النصي للدُفعات tools.media.audio.
يكشف Plugin المضمن من xAI عن x_search كأداة OpenClaw للبحث في محتوى X (Twitter سابقًا) عبر Grok.مسار الإعداد: plugins.entries.xai.config.xSearch
المفتاحالنوعالافتراضيالوصف
enabledboolean-تفعيل أو تعطيل x_search
modelstringgrok-4-1-fastالنموذج المستخدم لطلبات x_search
baseUrlstring-تجاوز عنوان URL الأساسي لاستجابات xAI
inlineCitationsboolean-تضمين الاستشهادات المضمنة في النتائج
maxTurnsnumber-الحد الأقصى لأدوار المحادثة
timeoutSecondsnumber-مهلة الطلب بالثواني
cacheTtlMinutesnumber-مدة بقاء التخزين المؤقت بالدقائق
{
  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
المفتاحالنوعالافتراضيالوصف
enabledbooleantrue (إذا كان المفتاح متاحًا)تفعيل أو تعطيل تنفيذ التعليمات البرمجية
modelstringgrok-4-1-fastالنموذج المستخدم لطلبات تنفيذ التعليمات البرمجية
maxTurnsnumber-الحد الأقصى لأدوار المحادثة
timeoutSecondsnumber-مهلة الطلب بالثواني
هذا تنفيذ بعيد في sandbox من xAI، وليس exec محليًا.
{
  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 محليًا.

​
الاختبار الحي

تغطي اختبارات الوحدة والمسارات الحية الاختيارية مسارات وسائط xAI. صدّر XAI_API_KEY في بيئة العملية قبل تشغيل عمليات الفحص الحية. 
pnpm test extensions/xai
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/xai.live.test.ts
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS=xai pnpm test:live -- test/image-generation.runtime.live.test.ts
ينشئ الملف الحي الخاص بالموفر TTS عاديًا، وTTS بصيغة PCM مناسبة للاتصالات الهاتفية، ويفرغ الصوت نصيًا عبر xAI STT بنمط الدُفعات، ويدفق نفس PCM عبر xAI STT الآني، وينشئ مخرجات تحويل النص إلى صورة، ويعدل صورة مرجعية. يتحقق ملف الصور الحي المشترك من موفر xAI نفسه عبر مسار اختيار وقت التشغيل والرجوع والتطبيع ومرفقات الوسائط في OpenClaw.

​
ذات صلة

اختيار النموذج

اختيار الموفرين ومراجع النماذج وسلوك تجاوز الفشل.

إنشاء الفيديو

معلمات أداة الفيديو المشتركة واختيار الموفر.

كل الموفرين

نظرة عامة أوسع على الموفرين.

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة وإصلاحاتها.