xAI

يستخدم مزود بحث الويب grok المضمن XAI_API_KEY أيضا:

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 فقط. لا يوجد بعد تدفق 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 المحلي.