xAI

Birlikte gelen grok web arama sağlayıcısı XAI_API_KEY veya bir Plugin web arama anahtarı kullanabilir:

openclaw config set tools.web.search.provider grok

Birlikte gelen xai Plugin'i, paylaşılan video_generate aracı üzerinden video üretimini kaydeder.

• Varsayılan video modeli: xai/grok-imagine-video
• Modlar: metinden videoya, görüntüden videoya, referans görüntü üretimi, uzak video düzenleme ve uzak video uzatma
• En-boy oranları: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Çözünürlükler: 480P, 720P
• Süre: üretim/görüntüden videoya için 1-15 saniye, reference_image rolleri kullanıldığında 1-10 saniye, uzatma için 2-10 saniye
• Referans görüntü üretimi: sağlanan her görüntü için imageRoles değerini reference_image olarak ayarlayın; xAI bu tür en fazla 7 görüntüyü kabul eder

Varsayılan video sağlayıcısı olarak xAI kullanmak için:

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

Birlikte gelen xai Plugin'i, paylaşılan image_generate aracı üzerinden görüntü üretimini kaydeder.

• Varsayılan görüntü modeli: xai/grok-imagine-image
• Ek model: xai/grok-imagine-image-pro
• Modlar: metinden görüntüye ve referans görüntü düzenleme
• Referans girdileri: bir image veya en fazla beş images
• En-boy oranları: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Çözünürlükler: 1K, 2K
• Sayı: en fazla 4 görüntü

OpenClaw, üretilen medyanın normal kanal ek yolu üzerinden saklanıp teslim edilebilmesi için xAI'den b64_json görüntü yanıtları ister. Yerel referans görüntüleri veri URL'lerine dönüştürülür; uzak http(s) referansları olduğu gibi geçirilir.

Varsayılan görüntü sağlayıcısı olarak xAI kullanmak için:

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

Birlikte gelen xai Plugin'i, paylaşılan tts sağlayıcı yüzeyi üzerinden metinden sese özelliğini kaydeder.

• Sesler: eve, ara, rex, sal, leo, una
• Varsayılan ses: eve
• Biçimler: mp3, wav, pcm, mulaw, alaw
• Dil: BCP-47 kodu veya auto
• Hız: sağlayıcıya özgü hız geçersiz kılması
• Yerel Opus sesli not biçimi desteklenmez

Varsayılan TTS sağlayıcısı olarak xAI kullanmak için:

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

Birlikte gelen xai Plugin'i, OpenClaw'ın medya anlama transkripsiyon yüzeyi üzerinden toplu sesten metne özelliğini kaydeder.

• Varsayılan model: grok-stt
• Uç nokta: xAI REST /v1/stt
• Girdi yolu: multipart ses dosyası yükleme
• OpenClaw tarafından, Discord ses kanalı segmentleri ve kanal ses ekleri dahil olmak üzere gelen ses transkripsiyonunun tools.media.audio kullandığı her yerde desteklenir

Gelen ses transkripsiyonu için xAI'yi zorlamak üzere:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

Dil, paylaşılan ses medya yapılandırması veya çağrı başına transkripsiyon isteği üzerinden sağlanabilir. İstem ipuçları paylaşılan OpenClaw yüzeyi tarafından kabul edilir, ancak xAI REST STT entegrasyonu yalnızca dosya, model ve dili iletir çünkü bunlar geçerli genel xAI uç noktasıyla temiz şekilde eşleşir.

Birlikte gelen xai Plugin'i, canlı sesli arama sesi için gerçek zamanlı bir transkripsiyon sağlayıcısı da kaydeder.

• Uç nokta: xAI WebSocket wss://api.x.ai/v1/stt
• Varsayılan kodlama: mulaw
• Varsayılan örnekleme hızı: 8000
• Varsayılan uç belirleme: 800ms
• Ara transkriptler: varsayılan olarak etkin

Voice Call'ın Twilio medya akışı G.711 µ-law ses kareleri gönderir, bu nedenle xAI sağlayıcısı bu kareleri kod çevrimi olmadan doğrudan iletebilir:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

Sağlayıcıya ait yapılandırma plugins.entries.voice-call.config.streaming.providers.xai altında bulunur. Desteklenen anahtarlar apiKey, baseUrl, sampleRate, encoding (pcm, mulaw veya alaw), interimResults, endpointingMs ve language değerleridir.

Paketle gelen xAI Plugin, X (eski adıyla Twitter) içeriklerini Grok üzerinden aramak için x_search aracını bir OpenClaw aracı olarak sunar.

Yapılandırma yolu: 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,          },        },      },    },  },}

Paketle gelen xAI Plugin, xAI'nin sandbox ortamında uzaktan kod yürütme için code_execution aracını bir OpenClaw aracı olarak sunar.

Yapılandırma yolu: plugins.entries.xai.config.codeExecution

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

• Kimlik doğrulama bugün yalnızca API anahtarıyla yapılır. API anahtarı bir xAI kimlik doğrulama profilinde, ortam değişkeninde veya Plugin yapılandırmasında saklanabilir; OpenClaw'da henüz xAI OAuth veya cihaz kodu akışı yoktur.
• grok-4.20-multi-agent-experimental-beta-0304, standart OpenClaw xAI aktarımından farklı bir upstream API yüzeyi gerektirdiği için normal xAI sağlayıcı yolunda desteklenmez.
• xAI Realtime ses henüz bir OpenClaw sağlayıcısı olarak kaydedilmemiştir. Toplu STT veya akış transkripsiyonundan farklı bir çift yönlü ses oturumu sözleşmesine ihtiyaç duyar.
• xAI görüntü quality, görüntü mask ve ek yalnızca yerel en boy oranları, paylaşılan image_generate aracında karşılık gelen sağlayıcılar arası kontroller bulunana kadar sunulmaz.

• OpenClaw, paylaşılan çalıştırıcı yolunda xAI'ye özgü araç şeması ve araç çağrısı uyumluluk düzeltmelerini otomatik olarak uygular.
• Yerel xAI isteklerinde varsayılan tool_stream: true değeridir. Devre dışı bırakmak için agents.defaults.models["xai/<model>"].params.tool_stream değerini false olarak ayarlayın.
• Paketle gelen xAI sarmalayıcısı, yerel xAI isteklerini göndermeden önce desteklenmeyen katı araç şeması bayraklarını ve reasoning payload anahtarlarını çıkarır.
• web_search, x_search ve code_execution, OpenClaw araçları olarak sunulur. OpenClaw, her sohbet turuna tüm yerel araçları eklemek yerine, her araç isteği içinde ihtiyaç duyduğu belirli xAI yerleşik aracını etkinleştirir.
• Grok web_search, plugins.entries.xai.config.webSearch.baseUrl değerini okur. x_search, plugins.entries.xai.config.xSearch.baseUrl değerini okur, ardından Grok web arama temel URL'sine geri döner.
• x_search ve code_execution, çekirdek model çalışma zamanına sabit kodlanmak yerine paketle gelen xAI Plugin tarafından sahiplenilir.
• code_execution, yerel exec değil, uzaktan xAI sandbox yürütmesidir.