xAI

Paketle birlikte gelen grok web araması sağlayıcısı öncelikle xAI OAuth'u tercih eder, ardından XAI_API_KEY veya bir plugin web araması anahtarını yedek olarak kullanır:

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

Paketle birlikte gelen xai plugini, paylaşılan video_generate aracı üzerinden video üretimini kaydeder.

• Varsayılan model: xai/grok-imagine-video
• Ek model: xai/grok-imagine-video-1.5
• Klasik modlar: metinden videoya, görselden videoya, referans görselle üretim, uzak video düzenleme ve uzak video uzatma
• Video 1.5 modu: yalnızca görselden videoya; tam olarak bir ilk kare görseliyle
• En-boy oranları: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; klasik ve Video 1.5 görselden videoya işlemleri, belirtilmediğinde kaynak görselin oranını devralır
• Çözünürlükler: klasik 480P/720P; Video 1.5 ayrıca 1080P destekler; tüm üretim modları varsayılan olarak 480P kullanır
• Süre: üretim/görselden videoya için 1-15 saniye, klasik reference_image rolleri kullanılırken 1-10 saniye, klasik uzatma için 2-10 saniye
• Referans görselle üretim: sağlanan her görsel için imageRoles değerini reference_image olarak ayarlayın; xAI bu tür en fazla 7 görseli kabul eder
• Video düzenleme/uzatma, giriş videosunun en-boy oranını ve çözünürlüğünü devralır; bu işlemler geometri geçersiz kılmalarını kabul etmez
• Varsayılan işlem zaman aşımı: video_generate.timeoutMs veya agents.defaults.videoGenerationModel.timeoutMs ayarlanmadıkça 600 saniye

Video 1.5, xAI'ın grok-imagine-video-1.5-preview ve grok-imagine-video-1.5-2026-05-30 tanımlayıcılarını da tanır. OpenClaw, seçilen tanımlayıcıyı değiştirmeden iletir ancak aynı yalnızca görsel doğrulamasını uygular.

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

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

Paketle birlikte gelen xai plugini, paylaşılan image_generate aracı üzerinden görsel üretimini kaydeder.

• Varsayılan görüntü modeli: xai/grok-imagine-image
• Ek model: xai/grok-imagine-image-quality
• Modlar: metinden görüntü oluşturma ve referans görüntü düzenleme
• Referans girdileri: bir image veya en fazla üç images
• En-boy oranları: 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
• Çözünürlükler: 1K, 2K
• Sayı: en fazla 4 görüntü
• Varsayılan işlem zaman aşımı: image_generate.timeoutMs veya agents.defaults.imageGenerationModel.timeoutMs ayarlanmadığı sürece 600 saniye

OpenClaw, oluşturulan medyanın normal kanal eki yolu üzerinden depolanıp teslim edilebilmesi için xAI'dan b64_json görüntü yanıtları ister. Yerel referans görüntüler veri URL'lerine dönüştürülür; uzak http(s) referansları değiştirilmeden aktarılır.

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

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

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

• Sesler: xAI'dan kimlik doğrulamalı canlı katalog; şu komutla listeleyin: openclaw infer tts voices --provider xai
• Çevrimdışı yedek sesler: ara, eve, leo, rex, sal
• Varsayılan ses: eve
• Hesaba özel ses kimlikleri, yerleşik katalog yanıtında bulunmasalar bile iletilir
• 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ılma ayarı
• Yerel Opus sesli not biçimi desteklenmez

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

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

Paketle gelen xai Plugin'i, OpenClaw'ın medya anlama transkripsiyon yüzeyi üzerinden toplu konuşmadan metne dönüştürme özelliğini kaydeder.

• Uç nokta: xAI REST /v1/stt
• Girdi yolu: çok parçalı ses dosyası yüklemesi
• Model seçimi: xAI transkripsiyon modelini dahili olarak seçer; uç noktada model seçici yoktur
• Discord ses kanalı bölümleri ve kanal ses ekleri dâhil olmak üzere, gelen ses transkripsiyonunun tools.media.audio okuduğu her yerde kullanılır

Gelen ses transkripsiyonu için xAI kullanımını zorunlu kılmak üzere:

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

Dil, paylaşılan ses medyası 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, mevcut genel xAI uç noktasıyla yalnızca bunlar eşleştiği için sadece dosyayı ve dili iletir.

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

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

Voice Call'un Twilio medya akışı G.711 mu-law ses kareleri gönderdiğinden, xAI sağlayıcısı bu kareleri kod dönüştürme yapmadan doğrudan iletir:

{  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'i, Grok aracılığıyla X (eski adıyla Twitter) içeriğinde arama yapmak 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.3",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

Paketle gelen xAI Plugin'i, xAI'ın korumalı alan ortamında uzaktan kod yürütmek 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.3",          },        },      },    },  },}

• xAI kimlik doğrulaması; API anahtarı, ortam değişkeni, Plugin yapılandırması yedeği veya uygun bir xAI hesabıyla OAuth kullanabilir. OAuth, localhost geri çağrısı olmadan cihaz kodu doğrulamasını kullanır. Hangi hesapların OAuth API belirteçlerini alabileceğine xAI karar verir ve OpenClaw Grok Build uygulamasını gerektirmediği hâlde onay sayfasında Grok Build gösterilebilir.
• OpenClaw şu anda xAI çok aracılı model ailesini sunmaz. xAI bu modelleri Responses API üzerinden sağlar ancak modeller, OpenClaw'ın paylaşılan aracı döngüsünde kullanılan istemci tarafı veya özel araçları kabul etmez. Bkz. xAI çok aracılı sistem sınırlamaları.
• xAI Realtime voice henüz bir OpenClaw sağlayıcısı olarak kaydedilmemiştir. Toplu STT veya akışlı transkripsiyondan farklı bir çift yönlü ses oturumu sözleşmesi gerektirir.
• xAI görüntü quality, görüntü mask ve yerel auto en-boy oranı, paylaşılan image_generate aracında bunlara karşılık gelen sağlayıcılar arası denetimler bulunana kadar sunulmaz.

• OpenClaw, paylaşılan çalıştırıcı yolunda xAI'a özgü araç şeması ve araç çağrısı uyumluluk düzeltmelerini otomatik olarak uygular.
• Yerel xAI isteklerinde varsayılan değer tool_stream: true şeklindedir. 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 içerme sayısı şema sınırlarını ve desteklenmeyen akıl yürütme çabası yük anahtarlarını kaldırır. Grok 4.5 düşük, orta ve yüksek çabayı destekler (varsayılan yüksek). Grok 4.3; yok, düşük, orta ve yüksek çabayı destekler (varsayılan düşük). Akıl yürütme yeteneğine sahip diğer xAI modelleri yapılandırılabilir bir çaba denetimi sunmaz ancak sonraki turlarda önceki şifrelenmiş akıl yürütmenin yeniden oynatılabilmesi için yine de include: ["reasoning.encrypted_content"] isteğinde bulunur.
• web_search, x_search ve code_execution, OpenClaw araçları olarak sunulur. OpenClaw, her yerel aracı her sohbet turuna eklemek yerine yalnızca her aracın ihtiyaç duyduğu belirli xAI yerleşik aracını o aracın isteğine ekler.
• 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 araması temel URL'sini yedek olarak kullanır.
• x_search ve code_execution, çekirdek model çalışma zamanında sabit kodlanmak yerine paketle gelen xAI Plugin'ine aittir.
• code_execution, yerel exec değil, uzaktaki xAI korumalı alanında yürütmedir.