Ana içeriğe atla

​
xAI

OpenClaw, Grok modelleri için paketli bir xai provider Plugin’i sunar.

​
Başlarken

1

Bir API anahtarı oluşturun

xAI console içinde bir API anahtarı oluşturun.
2

API anahtarınızı ayarlayın

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

Bir model seçin

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
OpenClaw, paketli xAI taşıma katmanı olarak xAI Responses API’sini kullanır. Aynı XAI_API_KEY, Grok destekli web_search, birinci sınıf x_search ve uzak code_execution için de kullanılabilir. Bir xAI anahtarını plugins.entries.xai.config.webSearch.apiKey altında saklarsanız, paketli xAI model provider’ı da bu anahtarı yedek olarak yeniden kullanır. code_execution ayarlamaları plugins.entries.xai.config.codeExecution altında bulunur.

​
Paketli model kataloğu

OpenClaw, kutudan çıktığı hâliyle şu xAI model ailelerini içerir:
AileModel kimlikleri
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
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 ayrıca, aynı API biçimini izlediklerinde daha yeni grok-4* ve grok-code-fast* kimliklerini de ileri çözümleme ile destekler.
grok-4-fast, grok-4-1-fast ve grok-4.20-beta-* varyantları, paketli katalogdaki güncel görsel destekli Grok başvurularıdır.

​
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 paketli kimliklere normalize edilir:
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

Paketli grok web-search provider’ı da XAI_API_KEY kullanır:
openclaw config set tools.web.search.provider grok
Paketli xai Plugin’i, paylaşılan video_generate aracı üzerinden video üretimini kaydeder.
  • Varsayılan video modeli: xai/grok-imagine-video
  • Modlar: text-to-video, image-to-video ve uzak video düzenleme/uzatma akışları
  • aspectRatio ve resolution destekler
Yerel video arabellekleri kabul edilmez. Video referansı ve düzenleme girdileri için uzak http(s) URL’leri kullanın.
xAI’yi varsayılan video provider’ı olarak kullanmak için:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Paylaşılan araç parametreleri, provider seçimi ve failover davranışı için bkz. Video Üretimi.
Paketli xAI Plugin’i, Grok üzerinden 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
AnahtarTürVarsayılanAçıklama
enabledboolean—x_search’ü etkinleştirir veya devre dışı bırakır
modelstringgrok-4-1-fastx_search istekleri için kullanılan model
inlineCitationsboolean—Sonuçlara satır içi alıntılar ekler
maxTurnsnumber—Azami konuşma dönüşü
timeoutSecondsnumber—Saniye cinsinden istek zaman aşımı
cacheTtlMinutesnumber—Dakika cinsinden cache yaşam süresi
{
  plugins: {
    entries: {
      xai: {
        config: {
          xSearch: {
            enabled: true,
            model: "grok-4-1-fast",
            inlineCitations: true,
          },
        },
      },
    },
  },
}
Paketli xAI Plugin’i, xAI’nin sandbox ortamında uzak 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)code execution’ı etkinleştirir veya devre dışı bırakır
modelstringgrok-4-1-fastcode execution istekleri için kullanılan model
maxTurnsnumber—Azami konuşma dönüşü
timeoutSecondsnumber—Saniye cinsinden istek zaman aşımı
Bu, yerel exec değil, uzak xAI sandbox yürütmesidir.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
          },
        },
      },
    },
  },
}
  • Kimlik doğrulama şu anda yalnızca API anahtarıyladır. OpenClaw’da henüz xAI OAuth veya cihaz kodu akışı yoktur.
  • grok-4.20-multi-agent-experimental-beta-0304, standart OpenClaw xAI taşımasından farklı bir yukarı akış API yüzeyi gerektirdiği için normal xAI provider yolunda desteklenmez.
  • 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 olarak tool_stream: true kullanılır. Bunu devre dışı bırakmak için agents.defaults.models["xai/<model>"].params.tool_stream değerini false olarak ayarlayın.
  • Paketli xAI sarmalayıcısı, yerel xAI isteklerini göndermeden önce desteklenmeyen katı araç şeması flag’lerini ve akıl yürütme payload anahtarlarını kaldırır.
  • web_search, x_search ve code_execution, OpenClaw araçları olarak sunulur. OpenClaw, her sohbet dönüşüne tüm yerel araçları eklemek yerine her araç isteği içinde ihtiyaç duyduğu belirli xAI yerleşik aracını etkinleştirir.
  • x_search ve code_execution, core model çalışma zamanına sabit kodlanmak yerine paketli xAI Plugin’ine aittir.
  • code_execution, yerel exec değil, uzak xAI sandbox yürütmesidir.

​
İlgili

Model seçimi

Provider’ları, model başvurularını ve failover davranışını seçme.

Video üretimi

Paylaşılan video aracı parametreleri ve provider seçimi.

Tüm provider'lar

Daha geniş provider genel bakışı.

Sorun giderme

Yaygın sorunlar ve düzeltmeler.