xAI

Penyedia web-search grok bawaan lebih memilih OAuth xAI, lalu beralih ke XAI_API_KEY atau kunci web-search Plugin jika diperlukan:

openclaw models auth login --provider xai --method oauthopenclaw config set tools.web.search.provider grok

Plugin xai bawaan mendaftarkan generasi video melalui alat bersama video_generate.

• Model video default: xai/grok-imagine-video
• Mode: text-to-video, image-to-video, generasi reference-image, edit video jarak jauh, dan ekstensi video jarak jauh
• Rasio aspek: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Resolusi: 480P, 720P
• Durasi: 1-15 detik untuk generasi/image-to-video, 1-10 detik saat menggunakan peran reference_image, 2-10 detik untuk ekstensi
• Generasi reference-image: atur imageRoles ke reference_image untuk setiap gambar yang disediakan; xAI menerima hingga 7 gambar seperti itu
• Timeout operasi default: 600 detik kecuali video_generate.timeoutMs atau agents.defaults.videoGenerationModel.timeoutMs diatur

Untuk menggunakan xAI sebagai penyedia video default:

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

Plugin xai bawaan mendaftarkan generasi gambar melalui alat bersama image_generate.

• Model gambar default: xai/grok-imagine-image
• Model tambahan: xai/grok-imagine-image-quality
• Mode: text-to-image dan edit reference-image
• Input referensi: satu image atau hingga lima images
• Rasio aspek: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resolusi: 1K, 2K
• Jumlah: hingga 4 gambar
• Timeout operasi default: 600 detik kecuali image_generate.timeoutMs atau agents.defaults.imageGenerationModel.timeoutMs diatur

OpenClaw meminta respons gambar b64_json dari xAI agar media yang dihasilkan dapat disimpan dan dikirim melalui jalur lampiran saluran normal. Gambar referensi lokal dikonversi menjadi URL data; referensi http(s) jarak jauh diteruskan apa adanya.

Untuk menggunakan xAI sebagai penyedia gambar default:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

Plugin xai bawaan mendaftarkan text-to-speech melalui permukaan penyedia tts bersama.

• Suara: eve, ara, rex, sal, leo, una
• Suara default: eve
• Format: mp3, wav, pcm, mulaw, alaw
• Bahasa: kode BCP-47 atau auto
• Kecepatan: override kecepatan native penyedia
• Format catatan suara Opus native tidak didukung

Untuk menggunakan xAI sebagai penyedia TTS default:

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

Plugin xai bawaan mendaftarkan speech-to-text batch melalui permukaan transkripsi pemahaman media OpenClaw.

• Model default: grok-stt
• Endpoint: xAI REST /v1/stt
• Jalur input: unggahan file audio multipart
• Didukung oleh OpenClaw di mana pun transkripsi audio masuk menggunakan tools.media.audio, termasuk segmen kanal suara Discord dan lampiran audio kanal

Untuk memaksa xAI untuk transkripsi audio masuk:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

Bahasa dapat disediakan melalui konfigurasi media audio bersama atau permintaan transkripsi per panggilan. Petunjuk prompt diterima oleh permukaan OpenClaw bersama, tetapi integrasi xAI REST STT hanya meneruskan file, model, dan bahasa karena semuanya dipetakan dengan jelas ke endpoint publik xAI saat ini.

Plugin xai bawaan juga mendaftarkan penyedia transkripsi realtime untuk audio panggilan suara live.

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• Encoding default: mulaw
• Sample rate default: 8000
• Endpointing default: 800ms
• Transkrip sementara: diaktifkan secara default

Stream media Twilio milik Voice Call mengirim frame audio G.711 µ-law, sehingga penyedia xAI dapat meneruskan frame tersebut secara langsung tanpa transcoding:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

Konfigurasi milik penyedia berada di bawah plugins.entries.voice-call.config.streaming.providers.xai. Kunci yang didukung adalah apiKey, baseUrl, sampleRate, encoding (pcm, mulaw, atau alaw), interimResults, endpointingMs, dan language.

Plugin xAI bawaan mengekspos x_search sebagai alat OpenClaw untuk mencari konten X (sebelumnya Twitter) melalui Grok.

Jalur konfigurasi: 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,          },        },      },    },  },}

Plugin xAI bawaan mengekspos code_execution sebagai alat OpenClaw untuk eksekusi kode jarak jauh di lingkungan sandbox xAI.

Jalur konfigurasi: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• Autentikasi xAI dapat menggunakan kunci API, variabel lingkungan, fallback konfigurasi plugin, atau OAuth dengan akun xAI yang memenuhi syarat. OAuth menggunakan verifikasi device-code tanpa callback localhost. xAI menentukan akun mana yang dapat menerima token API OAuth, dan halaman persetujuan dapat menampilkan Grok Build meskipun OpenClaw tidak memerlukan aplikasi Grok Build.
• OpenClaw saat ini tidak mengekspos keluarga model multi-agent xAI. xAI menyajikan model ini melalui Responses API, tetapi model tersebut tidak menerima alat sisi klien atau alat kustom yang digunakan oleh loop agen bersama OpenClaw. Lihat batasan multi-agent xAI.
• Suara xAI Realtime belum terdaftar sebagai penyedia OpenClaw. Fitur ini memerlukan kontrak sesi suara dua arah yang berbeda dari STT batch atau transkripsi streaming.
• quality gambar xAI, mask gambar, dan rasio aspek tambahan khusus native tidak diekspos hingga alat image_generate bersama memiliki kontrol lintas penyedia yang sesuai.

• OpenClaw menerapkan perbaikan kompatibilitas skema alat dan panggilan alat khusus xAI secara otomatis pada jalur runner bersama.
• Permintaan xAI native menggunakan default tool_stream: true. Atur agents.defaults.models["xai/<model>"].params.tool_stream ke false untuk menonaktifkannya.
• Wrapper xAI bawaan menghapus flag skema alat strict yang tidak didukung dan kunci payload reasoning effort sebelum mengirim permintaan xAI native. Hanya grok-4.3 / grok-4.3-* yang mengiklankan effort reasoning yang dapat dikonfigurasi; semua model xAI lain yang mampu reasoning tetap meminta include: ["reasoning.encrypted_content"] agar reasoning terenkripsi sebelumnya dapat diputar ulang pada giliran lanjutan.
• web_search, x_search, dan code_execution diekspos sebagai alat OpenClaw. OpenClaw mengaktifkan xAI built-in spesifik yang dibutuhkan di dalam setiap permintaan alat, bukan melampirkan semua alat native ke setiap giliran chat.
• Grok web_search membaca plugins.entries.xai.config.webSearch.baseUrl. x_search membaca plugins.entries.xai.config.xSearch.baseUrl, lalu fallback ke URL dasar web-search Grok.
• x_search dan code_execution dimiliki oleh plugin xAI bawaan, bukan di-hardcode ke runtime model inti.
• code_execution adalah eksekusi sandbox xAI jarak jauh, bukan exec lokal.