Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw, Grok modelleri için birlikte gelen bir xai sağlayıcı Plugin’i ile gelir.

​
Başlarken

1

Create an API key

xAI konsolunda bir API anahtarı oluşturun.
2

Set your API key

XAI_API_KEY ayarını yapın veya şunu çalıştırın:
openclaw onboard --auth-choice xai-api-key
3

Pick a model

{
  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:
AileModel kimlikleri
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
Grok 4.3grok-4.3
Grok 4grok-4, grok-4-0709
Grok 4 Fastgrok-4-fast, grok-4-fast-non-reasoning
Grok 4.1 Fastgrok-4-1-fast, grok-4-1-fast-non-reasoning
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Grok Codegrok-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ğiOpenClaw yüzeyiDurum
Sohbet / Responsesxai/<model> model sağlayıcısıEvet
Sunucu tarafı web aramasıweb_search sağlayıcısı 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-Sunulmaz; OpenClaw’ın TTS sözleşmesi tam ses arabellekleri döndürür
Toplu sesten metnetools.media.audio / medya anlamaEvet
Akışlı sesten metneVoice Call streaming.provider: "xai"Evet
Gerçek zamanlı ses-Henüz sunulmaz; 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 üst akış yetenekleri olarak belgelenmiştir.

​
Hızlı mod eşlemeleri

/fast on veya agents.defaults.models["xai/<model>"].params.fastMode: true yerel xAI isteklerini şu şekilde 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 birlikte gelen kimliklere normalleştirilir:
Eski takma adKanonik kimlik
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

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:
{
  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 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:
{
  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:
{
  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:
{
  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.
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
AnahtarTürVarsayılanAçıklama
enabledboolean-x_search’ü etkinleştir veya devre dışı bırak
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 atıflar ekle
maxTurnsnumber-En fazla 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 aracını 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ştir veya devre dışı bırak
modelstringgrok-4-1-fastKod yürütme istekleri için kullanılan model
maxTurnsnumber-En fazla 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",
          },
        },
      },
    },
  },
}
  • 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.

​
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. 
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

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Video oluşturma

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.