--- read_when: - OpenClaw'da Grok modellerini kullanmak istiyorsunuz - xAI kimlik doğrulamasını veya model kimliklerini yapılandırıyorsunuz summary: OpenClaw'da xAI Grok modellerini kullanın title: xAI x-i18n: generated_at: "2026-05-10T19:53:00Z" model: gpt-5.5 provider: openai source_hash: f11c31e7ff39e7e13465b48d819db3921a32ed624676a57dc38f97c0dbd21e46 source_path: providers/xai.md workflow: 16 --- OpenClaw, Grok modelleri için birlikte gelen bir `xai` sağlayıcı Plugin'i ile gelir. ## Başlarken [xAI konsolunda](https://console.x.ai/) bir API anahtarı oluşturun. `XAI_API_KEY` ayarını yapın veya şunu çalıştırın: ```bash openclaw onboard --auth-choice xai-api-key ``` ```json5 { agents: { defaults: { model: { primary: "xai/grok-4.3" } } }, } ``` OpenClaw, birlikte gelen xAI aktarımı olarak xAI Responses API'yi kullanır. `openclaw onboard --auth-choice xai-api-key` ile kullanılan aynı API anahtarı, birinci sınıf `x_search` ve uzak `code_execution` özelliklerini de çalıştırabilir; `XAI_API_KEY` veya Plugin web arama yapılandırması da Grok destekli `web_search` özelliğini çalıştırabilir. Bir xAI anahtarını `plugins.entries.xai.config.webSearch.apiKey` altında saklarsanız, birlikte gelen xAI model sağlayıcısı bu anahtarı yedek olarak da yeniden kullanır. Grok `web_search` ve varsayılan olarak `x_search` trafiğini bir operatör xAI Responses proxy'si üzerinden yönlendirmek için `plugins.entries.xai.config.webSearch.baseUrl` ayarını yapın. `code_execution` ayarlamaları `plugins.entries.xai.config.codeExecution` altında yer alır. ## Yerleşik katalog OpenClaw, kullanıma hazır olarak şu xAI model ailelerini içerir: | Aile | Model kimlikleri | | -------------- | ------------------------------------------------------------------------ | | Grok 3 | `grok-3`, `grok-3-fast`, `grok-3-mini`, `grok-3-mini-fast` | | Grok 4.3 | `grok-4.3` | | Grok 4 | `grok-4`, `grok-4-0709` | | Grok 4 Fast | `grok-4-fast`, `grok-4-fast-non-reasoning` | | Grok 4.1 Fast | `grok-4-1-fast`, `grok-4-1-fast-non-reasoning` | | Grok 4.20 Beta | `grok-4.20-beta-latest-reasoning`, `grok-4.20-beta-latest-non-reasoning` | | Grok Code | `grok-code-fast-1` | Plugin, aynı API yapısını izlediklerinde daha yeni `grok-4*` ve `grok-code-fast*` kimliklerini de ileriye dönük olarak çözümler. `grok-4.3`, `grok-4-fast`, `grok-4-1-fast` ve `grok-4.20-beta-*` varyantları, birlikte gelen katalogdaki geçerli görüntü destekli Grok referanslarıdır. ## OpenClaw özellik kapsamı Birlikte gelen Plugin, xAI'nin geçerli genel API yüzeyini OpenClaw'ın paylaşılan sağlayıcı ve araç sözleşmeleriyle eşler. Paylaşılan sözleşmeye uymayan yetenekler (örneğin akışlı TTS ve gerçek zamanlı ses) sunulmaz - aşağıdaki tabloya bakın. | xAI yeteneği | OpenClaw yüzeyi | Durum | | -------------------------- | ----------------------------------------- | ------------------------------------------------------------------- | | Sohbet / Responses | `xai/` model sağlayıcısı | Evet | | Sunucu tarafı web araması | `web_search` sağlayıcısı `grok` | Evet | | Sunucu tarafı X araması | `x_search` aracı | Evet | | Sunucu tarafı kod yürütme | `code_execution` aracı | Evet | | Görüntüler | `image_generate` | Evet | | Videolar | `video_generate` | Evet | | Toplu metinden sese | `messages.tts.provider: "xai"` / `tts` | Evet | | Akışlı TTS | - | Sunulmaz; OpenClaw'ın TTS sözleşmesi tam ses arabellekleri döndürür | | Toplu sesten metne | `tools.media.audio` / medya anlama | Evet | | Akışlı sesten metne | Voice Call `streaming.provider: "xai"` | Evet | | Gerçek zamanlı ses | - | Henüz sunulmaz; farklı oturum/WebSocket sözleşmesi | | Dosyalar / toplu işler | Yalnızca genel model API uyumluluğu | Birinci sınıf bir OpenClaw aracı değil | OpenClaw, medya üretimi, konuşma ve toplu transkripsiyon için xAI'nin REST görüntü/video/TTS/STT API'lerini, canlı sesli arama transkripsiyonu için xAI'nin akışlı STT WebSocket'ini ve model, arama ve kod yürütme araçları için Responses API'yi kullanır. Gerçek zamanlı ses oturumları gibi farklı OpenClaw sözleşmeleri gerektiren özellikler, burada gizli Plugin davranışı yerine üst akış yetenekleri olarak belgelenmiştir. ### Hızlı mod eşlemeleri `/fast on` veya `agents.defaults.models["xai/"].params.fastMode: true` yerel xAI isteklerini şu şekilde yeniden yazar: | Kaynak model | Hızlı mod hedefi | | ------------- | ----------------- | | `grok-3` | `grok-3-fast` | | `grok-3-mini` | `grok-3-mini-fast` | | `grok-4` | `grok-4-fast` | | `grok-4-0709` | `grok-4-fast` | ### Eski uyumluluk takma adları Eski takma adlar hâlâ kanonik birlikte gelen kimliklere normalleştirilir: | Eski takma ad | Kanonik kimlik | | ------------------------- | ------------------------------------- | | `grok-4-fast-reasoning` | `grok-4-fast` | | `grok-4-1-fast-reasoning` | `grok-4-1-fast` | | `grok-4.20-reasoning` | `grok-4.20-beta-latest-reasoning` | | `grok-4.20-non-reasoning` | `grok-4.20-beta-latest-non-reasoning` | ## Özellikler Birlikte gelen `grok` web arama sağlayıcısı `XAI_API_KEY` veya bir Plugin web arama anahtarı kullanabilir: ```bash 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 Yerel video arabellekleri kabul edilmez. Video düzenleme/uzatma girdileri için uzak `http(s)` URL'leri kullanın. Görüntüden videoya, yerel görüntü arabelleklerini kabul eder çünkü OpenClaw bunları xAI için veri URL'leri olarak kodlayabilir. Varsayılan video sağlayıcısı olarak xAI kullanmak için: ```json5 { agents: { defaults: { videoGenerationModel: { primary: "xai/grok-imagine-video", }, }, }, } ``` Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Video Üretimi](/tr/tools/video-generation) bölümüne bakın. 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: ```json5 { agents: { defaults: { imageGenerationModel: { primary: "xai/grok-imagine-image", }, }, }, } ``` xAI ayrıca `quality`, `mask`, `user` ve `1:2`, `2:1`, `9:20`, `20:9` gibi ek yerel oranları belgeler. OpenClaw bugün yalnızca paylaşılan çapraz sağlayıcı görüntü denetimlerini iletir; desteklenmeyen yalnızca yerel ayarlar bilinçli olarak `image_generate` üzerinden sunulmaz. 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: ```json5 { messages: { tts: { provider: "xai", providers: { xai: { voiceId: "eve", }, }, }, }, } ``` OpenClaw, xAI'nin toplu `/v1/tts` uç noktasını kullanır. xAI ayrıca WebSocket üzerinden akışlı TTS sunar, ancak OpenClaw konuşma sağlayıcı sözleşmesi şu anda yanıt tesliminden önce tam bir ses arabelleği bekler. 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: ```json5 { 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: ```json5 { 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. Bu akış sağlayıcısı, Voice Call'ın gerçek zamanlı transkripsiyon yolu içindir. Discord sesi şu anda kısa segmentler kaydeder ve bunun yerine toplu `tools.media.audio` transkripsiyon yolunu kullanır. 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` | Anahtar | Tür | Varsayılan | Açıklama | | ------------------ | ------- | ------------------ | ------------------------------------ | | `enabled` | boolean | - | x_search'ü etkinleştir veya devre dışı bırak | | `model` | string | `grok-4-1-fast` | x_search istekleri için kullanılan model | | `baseUrl` | string | - | xAI Responses temel URL geçersiz kılması | | `inlineCitations` | boolean | - | Sonuçlara satır içi atıflar ekle | | `maxTurns` | number | - | En fazla konuşma turu | | `timeoutSeconds` | number | - | Saniye cinsinden istek zaman aşımı | | `cacheTtlMinutes` | number | - | Dakika cinsinden önbellek yaşam süresi | ```json5 { 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` | Anahtar | Tür | Varsayılan | Açıklama | | ----------------- | ------- | ------------------ | ---------------------------------------- | | `enabled` | boolean | `true` (anahtar varsa) | Kod yürütmeyi etkinleştir veya devre dışı bırak | | `model` | string | `grok-4-1-fast` | Kod yürütme istekleri için kullanılan model | | `maxTurns` | number | - | En fazla konuşma turu | | `timeoutSeconds` | number | - | Saniye cinsinden istek zaman aşımı | Bu, yerel [`exec`](/tr/tools/exec) değil, uzaktan xAI sandbox yürütmesidir. ```json5 { 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/"].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`](/tr/tools/exec) değil, uzaktan xAI sandbox yürütmesidir. ## Canlı test xAI medya yolları birim testleri ve isteğe bağlı canlı test paketleriyle kapsanır. Canlı komutlar, `XAI_API_KEY` değerini yoklamadan önce `~/.profile` dahil olmak üzere oturum açma kabuğunuzdan gizli bilgileri yükler. ```bash 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 ``` Sağlayıcıya özgü canlı dosya normal TTS, telefon uyumlu PCM TTS sentezler, sesi xAI toplu STT üzerinden transkribe eder, aynı PCM'i xAI gerçek zamanlı STT üzerinden akıtır, metinden görüntü çıktısı oluşturur ve bir referans görüntüyü düzenler. Paylaşılan görüntü canlı dosyası, aynı xAI sağlayıcısını OpenClaw'ın çalışma zamanı seçimi, geri dönüş, normalleştirme ve medya eki yolu üzerinden doğrular. ## İlgili Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme. Paylaşılan video aracı parametreleri ve sağlayıcı seçimi. Daha geniş sağlayıcı genel bakışı. Yaygın sorunlar ve düzeltmeler.