xAI

Penyedia pencarian web grok bawaan mengutamakan OAuth xAI, lalu beralih ke XAI_API_KEY atau kunci pencarian web Plugin sebagai cadangan:

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

Plugin xai bawaan mendaftarkan pembuatan video melalui alat bersama video_generate.

• Model bawaan: xai/grok-imagine-video
• Model tambahan: xai/grok-imagine-video-1.5
• Mode klasik: teks-ke-video, gambar-ke-video, pembuatan dengan gambar referensi, pengeditan video jarak jauh, dan perpanjangan video jarak jauh
• Mode Video 1.5: hanya gambar-ke-video, dengan tepat satu gambar bingkai pertama
• Rasio aspek: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; gambar-ke-video klasik dan Video 1.5 mewarisi rasio gambar sumber jika tidak dicantumkan
• Resolusi: klasik 480P/720P; Video 1.5 juga mendukung 1080P; semua mode pembuatan menggunakan 480P secara bawaan
• Durasi: 1–15 detik untuk pembuatan/gambar-ke-video, 1–10 detik saat menggunakan peran klasik reference_image, 2–10 detik untuk perpanjangan klasik
• Pembuatan dengan gambar referensi: tetapkan imageRoles ke reference_image untuk setiap gambar yang diberikan; xAI menerima hingga 7 gambar tersebut
• Pengeditan/perpanjangan video mewarisi rasio aspek dan resolusi video masukan; operasi tersebut tidak menerima penggantian geometri
• Batas waktu operasi bawaan: 600 detik kecuali video_generate.timeoutMs atau agents.defaults.videoGenerationModel.timeoutMs ditetapkan

Video 1.5 juga mengenali pengenal grok-imagine-video-1.5-preview dan grok-imagine-video-1.5-2026-05-30 milik xAI. OpenClaw meneruskan pengenal yang dipilih tanpa perubahan, tetapi menerapkan validasi khusus gambar yang sama.

Untuk menggunakan xAI sebagai penyedia video bawaan:

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

Plugin xai bawaan mendaftarkan pembuatan gambar melalui alat bersama image_generate.

• Model gambar bawaan: xai/grok-imagine-image
• Model tambahan: xai/grok-imagine-image-quality
• Mode: teks-ke-gambar dan penyuntingan gambar referensi
• Masukan referensi: satu image atau hingga tiga images
• Rasio aspek: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
• Resolusi: 1K, 2K
• Jumlah: hingga 4 gambar
• Batas waktu operasi bawaan: 600 detik kecuali image_generate.timeoutMs atau agents.defaults.imageGenerationModel.timeoutMs ditetapkan

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 tanpa perubahan.

Untuk menggunakan xAI sebagai penyedia gambar bawaan:

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

Plugin xai bawaan mendaftarkan teks-ke-ucapan melalui permukaan penyedia tts bersama.

• Suara: katalog langsung terautentikasi dari xAI; tampilkan dengan openclaw infer tts voices --provider xai
• Suara cadangan luring: ara, eve, leo, rex, sal
• Suara bawaan: eve
• ID suara kustom akun diteruskan meskipun tidak terdapat dalam respons katalog bawaan
• Format: mp3, wav, pcm, mulaw, alaw
• Bahasa: kode BCP-47 atau auto
• Kecepatan: penggantian kecepatan bawaan penyedia
• Format catatan suara Opus bawaan tidak didukung

Untuk menggunakan xAI sebagai penyedia TTS bawaan:

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

Plugin xai bawaan mendaftarkan ucapan-ke-teks batch melalui permukaan transkripsi pemahaman media OpenClaw.

• Endpoint: REST xAI /v1/stt
• Jalur masukan: unggahan berkas audio multipart
• Pemilihan model: xAI memilih model transkripsi secara internal; endpoint tidak memiliki pemilih model
• Digunakan di setiap tempat transkripsi audio masuk membaca tools.media.audio, termasuk segmen saluran suara Discord dan lampiran audio saluran

Untuk memaksa penggunaan xAI bagi transkripsi audio masuk:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",          },        ],      },    },  },}

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

Plugin xai bawaan juga mendaftarkan penyedia transkripsi waktu nyata untuk audio panggilan suara langsung.

• Endpoint: WebSocket xAI wss://api.x.ai/v1/stt
• Pengodean bawaan: mulaw
• Laju sampel bawaan: 8000
• Penentuan akhir ucapan bawaan: 800ms
• Transkrip sementara: diaktifkan secara bawaan

Aliran media Twilio milik Voice Call mengirim bingkai audio G.711 mu-law, sehingga penyedia xAI meneruskan bingkai tersebut secara langsung tanpa transkode:

{  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.3",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

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

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

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4.3",          },        },      },    },  },}

• Autentikasi xAI dapat menggunakan kunci API, variabel lingkungan, konfigurasi Plugin sebagai cadangan, atau OAuth dengan akun xAI yang memenuhi syarat. OAuth menggunakan verifikasi kode perangkat tanpa panggilan balik localhost. xAI menentukan akun mana yang dapat menerima token API OAuth, dan halaman persetujuan mungkin menampilkan Grok Build meskipun OpenClaw tidak memerlukan aplikasi Grok Build.
• Saat ini OpenClaw tidak mengekspos keluarga model multiagen xAI. xAI menyediakan model-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 multiagen xAI.
• Suara xAI Realtime belum didaftarkan 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 auto bawaan tidak diekspos hingga alat bersama image_generate memiliki kontrol lintas penyedia yang sesuai.

• OpenClaw secara otomatis menerapkan perbaikan kompatibilitas skema alat dan panggilan alat khusus xAI pada jalur penjalan bersama.
• Permintaan xAI bawaan menggunakan tool_stream: true secara bawaan. Tetapkan agents.defaults.models["xai/<model>"].params.tool_stream menjadi false untuk menonaktifkannya.
• Pembungkus xAI bawaan menghapus batas jumlah kandungan yang tidak didukung dan kunci muatan upaya penalaran yang tidak didukung sebelum mengirim permintaan xAI bawaan. Grok 4.5 mendukung upaya rendah, sedang, dan tinggi (bawaan tinggi). Grok 4.3 mendukung tanpa upaya, rendah, sedang, dan tinggi (bawaan rendah). Model xAI lain yang mendukung penalaran tidak mengekspos kontrol upaya yang dapat dikonfigurasi, tetapi tetap meminta include: ["reasoning.encrypted_content"] agar penalaran terenkripsi sebelumnya dapat diputar ulang pada giliran lanjutan.
• web_search, x_search, dan code_execution diekspos sebagai alat OpenClaw. OpenClaw hanya melampirkan alat bawaan xAI tertentu yang diperlukan oleh setiap alat ke permintaannya, alih-alih melampirkan semua alat bawaan ke setiap giliran obrolan.
• web_search Grok membaca plugins.entries.xai.config.webSearch.baseUrl. x_search membaca plugins.entries.xai.config.xSearch.baseUrl, lalu menggunakan URL dasar pencarian web Grok sebagai cadangan.
• x_search dan code_execution dimiliki oleh Plugin xAI bawaan, bukan dikodekan langsung ke dalam runtime model inti.
• code_execution adalah eksekusi sandbox xAI jarak jauh, bukan exec lokal.