xAI

Paketlenmiş grok web araması sağlayıcısı da XAI_API_KEY kullanır:

openclaw config set tools.web.search.provider grok

Paketlenmiş xai Plugin'i, ortak 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

Varsayılan video sağlayıcısı olarak xAI kullanmak için:

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

Paketlenmiş xai Plugin'i, ortak 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 eki yolu üzerinden saklanıp iletilebilmesi 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",
      },
    },
  },
}

Paketlenmiş xai Plugin'i, ortak tts sağlayıcı yüzeyi üzerinden metinden sese işlevini 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

Varsayılan TTS sağlayıcısı olarak xAI kullanmak için:

{
  messages: {
    tts: {
      provider: "xai",
      providers: {
        xai: {
          voiceId: "eve",
        },
      },
    },
  },
}

Paketlenmiş xai Plugin'i, 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: çok parçalı ses dosyası yükleme
• Gelen ses transkripsiyonunun tools.media.audio kullandığı her yerde, Discord ses kanalı parçaları ve kanal ses ekleri dahil olmak üzere 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, ortak ses medya yapılandırması veya çağrı başına transkripsiyon isteği üzerinden sağlanabilir. İstem ipuçları ortak OpenClaw yüzeyi tarafından kabul edilir, ancak xAI REST STT entegrasyonu yalnızca dosya, model ve dili iletir; çünkü bunlar güncel herkese açık xAI uç noktasıyla temiz biçimde eşleşir.

Paketlenmiş 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ç 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 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ının sahip olduğu 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'i, 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

{
  plugins: {
    entries: {
      xai: {
        config: {
          xSearch: {
            enabled: true,
            model: "grok-4-1-fast",
            baseUrl: "https://api.x.ai/v1",
            inlineCitations: true,
          },
        },
      },
    },
  },
}

Paketle gelen xAI Plugin'i, xAI'ın korumalı alan 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

{
  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. 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 sağlayıcı yolunda desteklenmez.
• xAI Realtime voice henüz bir OpenClaw sağlayıcısı olarak kaydedilmemiştir. Toplu STT veya akış transkripsiyonundan farklı bir çift yönlü voice oturumu sözleşmesine ihtiyaç duyar.
• xAI image quality, image 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 bulunana kadar sunulmaz.

• OpenClaw, paylaşılan çalıştırıcı yolunda xAI'a özgü araç şeması ve araç çağrısı uyumluluk düzeltmelerini 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 isteklerini göndermeden önce desteklenmeyen katı araç şeması bayraklarını ve reasoning yük 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 yerleşik xAI 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'ine aittir.
• code_execution, yerel exec değil, uzaktan xAI korumalı alan yürütmesidir.