xAI

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

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

Paketle birlikte gelen xai Plugin'i, 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örüntüden videoya, referans görüntü üretimi, uzak video düzenleme ve uzak video uzatma
• Video 1.5 modu: tam olarak bir ilk kare görüntüsüyle yalnızca görüntüden videoya
• En-boy oranları: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; belirtilmediğinde klasik ve Video 1.5 görüntüden videoya modları kaynak görüntünün oranını devralır
• Çözünürlükler: klasik 480P/720P; Video 1.5 ayrıca 1080P destekler; tüm üretim modlarının varsayılanı 480P değeridir
• Süre: üretim/görüntüden 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ö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ü 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.mediaModels.video.timeoutMs ayarlanmadıkça 600 saniye

Video 1.5 ayrıca 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 yalnızca görüntü doğrulamasını aynı şekilde uygular.

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

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

Birlikte gelen xai Plugin'i, paylaşılan image_generate aracı üzerinden görsel oluşturmayı kaydeder.

• Varsayılan görsel modeli: xai/grok-imagine-image
• Ek model: xai/grok-imagine-image-quality
• Modlar: metinden görsele ve referans görsel 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örsel
• Varsayılan işlem zaman aşımı: image_generate.timeoutMs veya agents.defaults.mediaModels.image.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örsel yanıtları ister. Yerel referans görseller veri URL'lerine dönüştürülür; uzak http(s) referansları değiştirilmeden iletilir.

xAI'ı varsayılan görsel sağlayıcısı olarak 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 konuşmaya özelliğini kaydeder.

• Sesler: xAI'dan kimliği doğrulanmış 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ılması
• Yerel Opus sesli not biçimi desteklenmez

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

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

Birlikte gelen xai Plugin'i, OpenClaw'ın medya anlama transkripsiyon yüzeyi üzerinden toplu konuşmadan metne ö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 yalnızca dosya ve dili iletir, çünkü bunlar mevcut genel xAI uç noktasıyla 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ç noktalama: 800ms
• Ara transkriptler: varsayılan olarak etkin

Voice Call'un Twilio medya akışı G.711 mu-law ses kareleri gönderir; bu nedenle xAI sağlayıcısı bu kareleri kod dönüştürmesi 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 şeklindedir.

Birlikte gelen xai Plugin'i, paylaşılan registerRealtimeVoiceProvider sözleşmesi üzerinden Talk modu için Grok Voice Agent gerçek zamanlı oturumlarını kaydeder.

• Uç nokta: wss://api.x.ai/v1/realtime?model=<voice-model>
• Varsayılan model: grok-voice-latest
• Varsayılan ses: eve
• Aktarım: gateway-relay (iOS, Android ve Control UI aktarma yolları)
• Ses: PCM16 24 kHz veya G.711 µ-law 8 kHz
• Araya girme: xAI sunucu VAD'si yanıtı keser; OpenClaw sıraya alınmış oynatmayı temizler ve oynatılmamış sağlayıcı geçmişini kısaltır

Talk'u Gateway üzerinde yapılandırın:

{  talk: {    realtime: {      provider: "xai",      mode: "realtime",      transport: "gateway-relay",      brain: "agent-consult",      providers: {        xai: {          model: "grok-voice-latest",          voice: "eve",          // Yalnızca sağlayıcı tarafında oturumun yeniden oynatılması kabul edilebilirse etkinleştirin.          sessionResumption: false,        },      },    },  },  env: { XAI_API_KEY: "xai-..." },}

Voice Call veya paylaşılan gerçek zamanlı seçiciler aynı sağlayıcı eşlemesini yeniden kullandığında, sağlayıcıya ait yapılandırma plugins.entries.voice-call.config.realtime.providers.xai üzerinden de çözümlenir. Desteklenen anahtarlar apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs, prefixPaddingMs, reasoningEffort ve sessionResumption şeklindedir. reasoningEffort, xAI Voice Agent API'siyle eşleşecek şekilde yalnızca high veya none kabul eder.

xAI'ın sunucu VAD'si her zaman yanıtlar oluşturur ve ses kesintisini işler. consultRouting: "provider-direct" kullanın; zorunlu transkript yönlendirmesi ve giriş sesi kesintisinin devre dışı bırakılması xAI Voice Agent protokolü tarafından desteklenmez.

Birlikte 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,          },        },      },    },  },}

Birlikte 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ı bir 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ı kullanır. Hangi hesapların OAuth API belirteçleri alabileceğine xAI karar verir ve OpenClaw, Grok Build uygulamasını gerektirmese de onay sayfasında Grok Build gösterilebilir.
• OpenClaw şu anda xAI çok aracılı model ailesini kullanıma sunmaz. xAI, bu modelleri Responses API üzerinden sunar ancak modeller, OpenClaw'ın paylaşılan aracı döngüsünün kullandığı istemci tarafı veya özel araçları kabul etmez. Bkz. xAI çok aracılı sistem sınırlamaları.
• xAI Realtime ses şu anda yalnızca gateway aktarmalı Talk taşımasını sunar. Tarayıcının yönettiği sağlayıcı WebSocket oturumları henüz Control UI'a bağlanmamıştır.
• xAI görüntü quality, görüntü mask ve yalnızca yerel kullanıma özgü ek en-boy oranları, paylaşılan image_generate aracında bunlara karşılık gelen sağlayıcılar arası denetimler bulunana kadar kullanıma 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 tool_stream: true varsayılan olarak etkindir. 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 contains-count ş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 çabasız, 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 önceki şifrelenmiş akıl yürütmenin sonraki turlarda yeniden oynatılabilmesi için yine de include: ["reasoning.encrypted_content"] ister.
• 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 yerleşik xAI 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 ve ardından Grok web araması temel URL'sine geri döner.
• x_search ve code_execution, çekirdek model çalışma zamanına sabit kodlanmak yerine paketle gelen xAI plugin'i tarafından yönetilir.
• code_execution, yerel exec değil, uzak xAI korumalı alan yürütmesidir.