xAI

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 oauthopenclaw 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

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

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

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

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

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.

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

{  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

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