Ana içeriğe atla
OpenClaw, Grok modelleri için paketle gelen bir xai sağlayıcı Plugin ile gelir. Çoğu kullanıcı için önerilen yol, uygun bir SuperGrok veya X Premium aboneliğiyle Grok OAuth kullanmaktır. OpenClaw yerel öncelikli kalır: Gateway, yapılandırma, yönlendirme ve araçlar makinenizde çalışırken, Grok model istekleri xAI üzerinden kimlik doğrulaması yapar ve xAI API’sine gönderilir. OAuth bir xAI API anahtarı gerektirmez ve Grok Build uygulamasını da gerektirmez. OpenClaw, xAI’nin paylaşılan OAuth istemcisini kullandığı için xAI, izin ekranında yine de Grok Build gösterebilir.

​
Kurulum yolunuzu seçin

OpenClaw kurulum durumunuza uyan yolu kullanın:
1

Yeni OpenClaw kurulumu

Yeni bir yerel Gateway kurarken daemon kurulumu ile ilk kurulumu çalıştırın, ardından model/kimlik doğrulama adımında xAI/Grok OAuth seçeneğini seçin:
openclaw onboard --install-daemon
Bir VPS üzerinde veya SSH üzerinden xAI OAuth’u doğrudan seçin; OpenClaw cihaz kodu doğrulaması kullanır ve localhost geri çağrısı gerektirmez:
openclaw onboard --install-daemon --auth-choice xai-oauth
OAuth bir xAI API anahtarı gerektirmez. OpenClaw, Grok Build uygulamasını gerektirmez. OpenClaw, xAI’nin paylaşılan OAuth istemcisini kullandığı için xAI izin uygulamasını yine de Grok Build olarak etiketleyebilir.
2

Mevcut OpenClaw kurulumu

OpenClaw zaten yapılandırılmışsa yalnızca xAI’de oturum açın. Sırf Grok’u bağlamak için tam ilk kurulumu yeniden çalıştırmayın veya daemon’ı yeniden kurmayın:
openclaw models auth login --provider xai --method oauth
Oturum açtıktan sonra Grok’u varsayılan model yapmak için bunu ayrıca uygulayın:
openclaw models set xai/grok-4.3
Tam ilk kurulumu yalnızca Gateway, daemon, kanal, çalışma alanı veya başka kurulum tercihlerini bilerek değiştirmek istiyorsanız yeniden çalıştırın.
3

API anahtarı yolu

API anahtarı kurulumu, xAI Console anahtarları ve anahtar destekli sağlayıcı yapılandırması gerektiren medya yüzeyleri için çalışmaya devam eder:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
4

Bir model seçin

{
  agents: { defaults: { model: { primary: "xai/grok-4.3" } } },
}
OpenClaw, paketle gelen xAI taşıması olarak xAI Responses API’yi kullanır. openclaw models auth login --provider xai --method oauth veya openclaw models auth login --provider xai --method api-key ile alınan aynı kimlik bilgisi, birinci sınıf web_search, x_search, uzak code_execution ve xAI görüntü/video üretimini de çalıştırabilir. Konuşma ve transkripsiyon şu anda XAI_API_KEY veya sağlayıcı yapılandırması gerektirir. Grok destekli web_search, xAI OAuth’u tercih eder ve XAI_API_KEY veya plugin web araması yapılandırmasına geri döner. Bir xAI anahtarını plugins.entries.xai.config.webSearch.apiKey altında saklarsanız, paketle gelen xAI model sağlayıcısı bu anahtarı da yedek olarak yeniden kullanır. Grok web_search ve varsayılan olarak x_search isteklerini bir operatör xAI Responses proxy’si üzerinden yönlendirmek için plugins.entries.xai.config.webSearch.baseUrl değerini ayarlayın. code_execution ayarları plugins.entries.xai.config.codeExecution altında yer alır.

​
OAuth sorun giderme

  • SSH, Docker, VPS veya diğer uzak kurulumlar için openclaw models auth login --provider xai --method oauth kullanın; xAI OAuth, localhost geri çağrısı yerine cihaz kodu doğrulaması kullanır.
  • Oturum açma başarılı olur ancak Grok varsayılan model olmazsa openclaw models set xai/grok-4.3 komutunu çalıştırın.
  • Kaydedilmiş xAI kimlik doğrulama profillerini incelemek için şunu çalıştırın: 
    openclaw models auth list --provider xai
openclaw models status
  • Hangi hesapların OAuth API tokenları alabileceğine xAI karar verir. Bir hesap uygun değilse API anahtarı yolunu deneyin veya aboneliği xAI tarafında kontrol edin.
SSH, Docker veya bir VPS üzerinden oturum açarken xai-oauth kullanın. OpenClaw bir xAI URL’si ve kısa kod yazdırır; uzak süreç tamamlanan token değişimi için xAI’yi yoklarken oturum açmayı herhangi bir yerel tarayıcıda tamamlayın.

​
Yerleşik katalog

OpenClaw, model seçicilerde en yeniler önce sıralanacak şekilde güncel xAI sohbet modellerini hazır olarak içerir:
AileModel kimlikleri
Grok Build 0.1grok-build-0.1
Grok 4.3grok-4.3
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Plugin, mevcut yapılandırmalar için eski Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast ve Grok Code slug’larını hâlâ ileriye dönük çözer. Resmi Grok Code Fast takma adları grok-build-0.1 olarak normalleştirilir; OpenClaw artık seçilebilir katalogda kullanımdan kaldırılmış diğer upstream slug’ları göstermez.
Açıkça bir Grok 4.20 beta takma adına ihtiyaç duymadığınız sürece genel sohbet için grok-4.3, derleme/kodlama odaklı iş yükleri için grok-build-0.1 kullanın.

​
OpenClaw özellik kapsamı

Paketle gelen Plugin, xAI’nin mevcut genel API yüzeyini OpenClaw’ın paylaşılan sağlayıcı ve araç sözleşmelerine eşler. Paylaşılan sözleşmeye uymayan yetenekler (örneğin akışlı TTS ve gerçek zamanlı ses) açığa çıkarılmaz - aşağıdaki tabloya bakın.
xAI yeteneğiOpenClaw yüzeyiDurum
Sohbet / Responsesxai/<model> model sağlayıcıEvet
Sunucu tarafı web aramasıweb_search sağlayıcı grokEvet
Sunucu tarafı X aramasıx_search aracıEvet
Sunucu tarafı kod yürütmecode_execution aracıEvet
Görüntülerimage_generateEvet
Videolarvideo_generateEvet
Toplu metinden sesemessages.tts.provider: "xai" / ttsEvet
Akışlı TTS-Açığa çıkarılmaz; OpenClaw’ın TTS sözleşmesi eksiksiz ses arabellekleri döndürür
Toplu konuşmadan metnetools.media.audio / medya anlamaEvet
Akışlı konuşmadan metneVoice Call streaming.provider: "xai"Evet
Gerçek zamanlı ses-Henüz açığa çıkarılmadı; farklı oturum/WebSocket sözleşmesi
Dosyalar / toplu işlerYalnızca genel model API uyumluluğuBirinci 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 upstream yetenekler olarak belgelenir.

​
Hızlı mod eşlemeleri

/fast on veya agents.defaults.models["xai/<model>"].params.fastMode: true, yerel xAI isteklerini şöyle yeniden yazar:
Kaynak modelHızlı mod hedefi
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Eski uyumluluk takma adları

Eski takma adlar hâlâ kanonik paketli kimliklere normalleştirilir:
Eski takma adKanonik kimlik
grok-code-fast-1grok-build-0.1
grok-code-fastgrok-build-0.1
grok-code-fast-1-0825grok-build-0.1
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
Özellikler

Paketle gelen grok web araması sağlayıcısı xAI OAuth’u tercih eder, ardından XAI_API_KEY veya bir plugin web araması anahtarına geri döner:
openclaw models auth login --provider xai --method oauth
openclaw config set tools.web.search.provider grok
Paketle gelen xai Plugin, 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ü kabul eder
  • Varsayılan işlem zaman aşımı: video_generate.timeoutMs veya agents.defaults.videoGenerationModel.timeoutMs ayarlanmadıysa 600 saniye
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.
xAI’yi varsayılan video sağlayıcısı olarak kullanmak için:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Paylaşılan araç parametreleri, sağlayıcı seçimi ve failover davranışı için Video Üretimi bölümüne bakın.
Paketle gelen xai Plugin, 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-quality
  • 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ü
  • Varsayılan işlem zaman aşımı: image_generate.timeoutMs veya agents.defaults.imageGenerationModel.timeoutMs ayarlanmadıysa 600 saniye
OpenClaw, üretilen medyanın normal kanal eki yolu üzerinden saklanıp iletilebilmesi için xAI’den 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ı olduğu gibi geçirilir.xAI’yi varsayılan görüntü sağlayıcısı olarak kullanmak için:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "xai/grok-imagine-image",
      },
    },
  },
}
xAI ayrıca quality, mask, user ve 1:2, 2:1, 9:20 ve 20:9 gibi ek yerel oranları belgeler. OpenClaw bugün yalnızca sağlayıcılar arası ortak görüntü denetimlerini iletir; desteklenmeyen yalnızca yerel düğmeler bilinçli olarak image_generate üzerinden sunulmaz.
Paketle gelen xai Plugin, paylaşılan tts sağlayıcı yüzeyi üzerinden metinden konuşmayı 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ılma
  • Yerel Opus sesli not biçimi desteklenmez
xAI’yi varsayılan TTS sağlayıcısı olarak kullanmak için:
{
  messages: {
    tts: {
      provider: "xai",
      providers: {
        xai: {
          speakerVoiceId: "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ı sözleşmesi şu anda yanıt tesliminden önce eksiksiz bir ses arabelleği bekler.
Paketle gelen xai Plugin, OpenClaw’ın medya anlama transkripsiyon yüzeyi üzerinden toplu konuşmadan metne işlevini kaydeder.
  • Varsayılan model: grok-stt
  • Uç nokta: xAI REST /v1/stt
  • Girdi yolu: multipart ses dosyası yükleme
  • Gelen ses transkripsiyonunun tools.media.audio kullandığı her yerde, Discord ses kanalı segmentleri ve kanal ses ekleri dahil, OpenClaw tarafından 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 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, model ve dili iletir; çünkü bunlar mevcut genel xAI uç noktasıyla temiz biçimde eşleşir.
Paketle gelen xai Plugin, 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’ın Twilio medya akışı G.711 µ-law ses kareleri gönderir; bu nedenle xAI sağlayıcısı bu kareleri kod dönüştürme yapmadan 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.
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, Grok aracılığıyla X (eski adıyla Twitter) içeriğini aramak için x_search değerini bir OpenClaw aracı olarak sunar.Yapılandırma yolu: plugins.entries.xai.config.xSearch
AnahtarTürVarsayılanAçıklama
enabledboolean-x_search özelliğini etkinleştirir veya devre dışı bırakır
modelstringgrok-4-1-fastx_search istekleri için kullanılan model
baseUrlstring-xAI Responses temel URL geçersiz kılması
inlineCitationsboolean-Sonuçlara satır içi alıntılar ekler
maxTurnsnumber-Maksimum konuşma turu
timeoutSecondsnumber-Saniye cinsinden istek zaman aşımı
cacheTtlMinutesnumber-Dakika cinsinden önbellek yaşam süresi
{
  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 değerini bir OpenClaw aracı olarak sunar.Yapılandırma yolu: plugins.entries.xai.config.codeExecution
AnahtarTürVarsayılanAçıklama
enabledbooleantrue (anahtar varsa)Kod yürütmeyi etkinleştirir veya devre dışı bırakır
modelstringgrok-4-1-fastKod yürütme istekleri için kullanılan model
maxTurnsnumber-Maksimum konuşma turu
timeoutSecondsnumber-Saniye cinsinden istek zaman aşımı
Bu, yerel exec değil, uzaktan xAI sandbox yürütmesidir.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
          },
        },
      },
    },
  },
}
  • 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 tokenları alabileceğine xAI karar verir ve onay sayfası, OpenClaw Grok Build uygulamasını gerektirmese bile Grok Build gösterebilir.
  • OpenClaw şu anda xAI çok aracılı model ailesini sunmaz. xAI bu modelleri Responses API üzerinden sunar, ancak bunlar OpenClaw’ın paylaşılan agent döngüsünün kullandığı istemci tarafı veya özel araçları kabul etmez. Bkz. xAI çok aracılı sınırlamaları.
  • xAI Realtime voice henüz bir OpenClaw sağlayıcısı olarak kaydedilmedi. Toplu STT veya akışlı transkripsiyondan farklı bir çift yönlü ses oturumu sözleşmesi gerekir.
  • 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ı denetimler olana kadar sunulmaz.
  • OpenClaw, xAI’ye özgü araç şeması ve araç çağrısı uyumluluk düzeltmelerini paylaşılan çalıştırıcı yolunda otomatik olarak uygular.
  • Yerel xAI istekleri varsayılan olarak tool_stream: true kullanır. 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 istekleri göndermeden önce desteklenmeyen katı araç şeması bayraklarını ve reasoning effort yük anahtarlarını kaldırır. Yalnızca grok-4.3 / grok-4.3-* yapılandırılabilir reasoning effort duyurur; reasoning yeteneği olan diğer tüm xAI modelleri yine de include: ["reasoning.encrypted_content"] ister, böylece önceki şifrelenmiş reasoning sonraki turlarda yeniden oynatılabilir.
  • web_search, x_search ve code_execution OpenClaw araçları olarak sunulur. OpenClaw, tüm yerel araçları her sohbet turuna eklemek yerine her araç isteğinin 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.

​
Canlı test

xAI medya yolları birim testleri ve isteğe bağlı canlı paketlerle kapsanır. Canlı probları çalıştırmadan önce işlem ortamında XAI_API_KEY dışa aktarın. 
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, xAI toplu STT üzerinden sesi transkribe eder, aynı PCM’yi xAI gerçek zamanlı STT üzerinden akıtır, metinden görüntü çıktısı üretir 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, fallback, normalleştirme ve medya eki yolu üzerinden doğrular.

​
İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve failover davranışını seçme.

Video üretimi

Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.

Tüm sağlayıcılar

Daha geniş sağlayıcı genel bakışı.

Sorun giderme

Yaygın sorunlar ve düzeltmeler.