xAI

Penyedia pencarian web grok terintegrasi mengutamakan OAuth xAI, lalu menggunakan 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 terintegrasi mendaftarkan pembuatan video melalui alat bersama video_generate.

• Model default: xai/grok-imagine-video
• Model tambahan: xai/grok-imagine-video-1.5
• Mode klasik: teks-ke-video, gambar-ke-video, pembuatan 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 default
• 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 gambar referensi: atur 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 default: 600 detik kecuali video_generate.timeoutMs atau agents.defaults.videoGenerationModel.timeoutMs ditetapkan

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

Untuk menggunakan xAI sebagai penyedia video default:

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

Plugin xai bawaan mendaftarkan pembuatan gambar melalui alat image_generate bersama.

• Model gambar default: xai/grok-imagine-image
• Model tambahan: xai/grok-imagine-image-quality
• Mode: teks-ke-gambar dan pengeditan gambar referensi
• Input 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 default: 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 default:

{  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 fallback luring: ara, eve, leo, rex, sal
• Suara default: 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 native penyedia
• Format catatan suara Opus native tidak didukung

Untuk menggunakan xAI sebagai penyedia TTS default:

{  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 input: unggahan berkas audio multipart
• Pemilihan model: xAI memilih model transkripsi secara internal; endpoint tidak memiliki pemilih model
• Digunakan di mana pun 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 OpenClaw bersama, 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 default: mulaw
• Laju sampel default: 8000
• Penentuan akhir ucapan default: 800ms
• Transkrip sementara: diaktifkan secara default

Stream media Twilio milik Panggilan Suara 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 mendaftarkan sesi waktu nyata Agen Suara Grok untuk mode Bicara melalui kontrak registerRealtimeVoiceProvider bersama.

• Endpoint: wss://api.x.ai/v1/realtime?model=<voice-model>
• Model default: grok-voice-latest
• Suara default: eve
• Transport: gateway-relay (jalur relai iOS, Android, dan UI Kontrol)
• Audio: PCM16 24 kHz atau G.711 µ-law 8 kHz
• Interupsi pengguna: VAD server xAI menginterupsi respons; OpenClaw menghapus antrean pemutaran dan memangkas riwayat penyedia yang belum diputar

Konfigurasikan Bicara pada Gateway:

{  talk: {    realtime: {      provider: "xai",      mode: "realtime",      transport: "gateway-relay",      brain: "agent-consult",      providers: {        xai: {          model: "grok-voice-latest",          voice: "eve",          // Ikut serta hanya jika pemutaran ulang sesi di sisi penyedia dapat diterima.          sessionResumption: false,        },      },    },  },  env: { XAI_API_KEY: "xai-..." },}

Konfigurasi milik penyedia juga diselesaikan dari plugins.entries.voice-call.config.realtime.providers.xai saat Panggilan Suara atau pemilih waktu nyata bersama menggunakan kembali peta penyedia yang sama. Kunci yang didukung adalah apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs, prefixPaddingMs, reasoningEffort, dan sessionResumption. reasoningEffort hanya menerima high atau none, sesuai dengan API Agen Suara xAI.

VAD server xAI selalu membuat respons dan menangani interupsi audio. Gunakan consultRouting: "provider-direct"; perutean transkrip paksa dan penonaktifan interupsi audio input tidak didukung oleh protokol Agen Suara xAI.

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 di 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, fallback konfigurasi plugin, atau OAuth dengan akun xAI yang memenuhi syarat. OAuth menggunakan verifikasi kode perangkat tanpa callback 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.
• OpenClaw saat ini 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 Realtime xAI saat ini hanya mengekspos transport Talk melalui relai gateway. Sesi WebSocket penyedia yang dikelola browser belum dihubungkan di Control UI.
• quality gambar xAI, mask gambar, dan rasio aspek tambahan khusus native belum diekspos hingga alat bersama image_generate memiliki kontrol lintas penyedia yang sesuai.

• OpenClaw menerapkan perbaikan kompatibilitas skema alat dan pemanggilan alat khusus xAI secara otomatis pada jalur runner bersama.
• Permintaan native xAI menggunakan tool_stream: true secara default. Atur agents.defaults.models["xai/<model>"].params.tool_stream ke false untuk menonaktifkannya.
• Wrapper xAI bawaan menghapus batas jumlah contains yang tidak didukung dan kunci payload effort penalaran yang tidak didukung sebelum mengirim permintaan native xAI. Grok 4.5 mendukung tingkat upaya rendah, sedang, dan tinggi (default tinggi). Grok 4.3 mendukung tanpa upaya, rendah, sedang, dan tinggi (default rendah). Model xAI lain yang mampu melakukan 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 fitur bawaan xAI tertentu yang diperlukan setiap alat ke permintaan alat tersebut, alih-alih melampirkan setiap alat native ke setiap giliran obrolan.
• Grok web_search membaca plugins.entries.xai.config.webSearch.baseUrl. x_search membaca plugins.entries.xai.config.xSearch.baseUrl, lalu melakukan fallback ke URL dasar pencarian web Grok.
• x_search dan code_execution dimiliki oleh plugin xAI bawaan, bukan di-hardcode ke dalam runtime model inti.
• code_execution adalah eksekusi sandbox xAI jarak jauh, bukan exec lokal.