xai terintegrasi untuk model Grok. Jalur yang
direkomendasikan adalah OAuth Grok dengan langganan SuperGrok atau X Premium
yang memenuhi syarat. Gateway, konfigurasi, perutean, dan alat tetap lokal; hanya permintaan
Grok yang dikirim ke API xAI.
OAuth tidak memerlukan kunci API xAI atau aplikasi Grok Build. xAI mungkin masih
menampilkan Grok Build di layar persetujuan karena OpenClaw menggunakan klien
OAuth bersama milik xAI.
Penyiapan
1
Instalasi baru
Jalankan orientasi awal dengan instalasi daemon, lalu pilih OAuth xAI/Grok pada
langkah model/autentikasi:Di VPS atau melalui SSH, pilih OAuth xAI secara langsung; metode ini menggunakan verifikasi
kode perangkat dan tidak memerlukan callback localhost:
2
Instalasi yang sudah ada
Masuk hanya ke xAI; jangan menjalankan ulang seluruh orientasi awal hanya untuk menghubungkan Grok:Terapkan Grok sebagai model default secara terpisah:Jalankan ulang seluruh orientasi awal hanya jika memang ingin mengubah Gateway,
daemon, kanal, ruang kerja, atau pilihan penyiapan lainnya.
3
Jalur kunci API
Penyiapan kunci API tetap berfungsi untuk kunci xAI Console dan permukaan media
yang memerlukan konfigurasi penyedia berbasis kunci:
4
Pilih model
OpenClaw menggunakan Responses API xAI sebagai transportasi xAI terintegrasi. Kredensial yang sama
dari
openclaw models auth login --provider xai --method oauth atau
--method api-key juga mendukung web_search (id penyedia grok), x_search,
code_execution, ucapan/transkripsi, serta pembuatan gambar/video xAI. Jika
kunci xAI disimpan di bawah plugins.entries.xai.config.webSearch.apiKey,
penyedia model xAI terintegrasi juga menggunakannya kembali sebagai cadangan.Pemecahan masalah OAuth
-
Untuk SSH, Docker, VPS, atau penyiapan jarak jauh lainnya, gunakan
openclaw models auth login --provider xai --method oauth; metode ini menggunakan verifikasi kode perangkat, bukan callback localhost. -
Jika proses masuk berhasil tetapi Grok bukan model default, jalankan
openclaw models set xai/grok-4.3. -
Periksa profil autentikasi xAI yang tersimpan:
- xAI menentukan akun mana yang dapat menerima token API OAuth. Jika suatu akun tidak memenuhi syarat, gunakan jalur kunci API atau periksa langganan di sisi xAI.
Katalog bawaan
ID yang dapat dipilih dalam pemilih model. Plugin tetap menangani ID Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast, dan Grok Code lama untuk konfigurasi yang sudah ada; lihat kompatibilitas lama dan alias yang berubah.
Metadata konteks katalog dan biaya token mengikuti
halaman model serta
halaman harga xAI yang aktif. xAI menerapkan tarif lebih tinggi
ketika permintaan melampaui ambang konteks panjang yang didokumentasikan; kolom biaya katalog tetap
OpenClaw mencatat tarif konteks pendek. Grok Build, CLI agen pemrograman terpisah
milik xAI, tersedia di x.ai/cli dan saat ini
menggunakan Grok 4.5.
Cakupan fitur
Plugin terintegrasi memetakan API xAI yang didukung ke kontrak penyedia dan alat bersama OpenClaw. Kemampuan yang tidak sesuai dengan kontrak bersama dicantumkan di bawah atau pada bagian batasan yang diketahui.OpenClaw menggunakan API REST gambar/video/TTS/STT xAI untuk pembuatan media dan
transkripsi batch, WebSocket STT streaming xAI untuk transkripsi panggilan suara
langsung, WebSocket Grok Voice Agent xAI untuk sesi Talk waktu nyata,
serta Responses API untuk percakapan, pencarian, dan alat eksekusi kode.
Kompatibilitas mode cepat lama
/fast on atau agents.defaults.models["xai/<model>"].params.fastMode: true
tetap menulis ulang konfigurasi xAI lama sebagai berikut. ID target ini
dipertahankan hanya untuk kompatibilitas; gunakan model yang saat ini dapat dipilih untuk
konfigurasi baru.
Kompatibilitas lama dan alias yang berubah
Alias lama dinormalisasi sebagai berikut:
ID 0309 bertanggal merupakan entri katalog yang dapat dipilih. OpenClaw mengirim semua alias
Grok 4.20 aktif lainnya secara verbatim agar xAI tetap mengendalikan semantik alias stabil, terbaru,
beta, eksperimental, dan bertanggal. Alias global
grok-latest
juga dipertahankan secara verbatim.
xAI telah menghentikan ID persis berikut. OpenClaw mempertahankannya sebagai baris kompatibilitas
tersembunyi untuk konfigurasi yang telah dirilis, dengan batasan dan harga target
pengalihan saat ini:
openclaw doctor --fix memperbarui default alat server xAI yang dipersistenkan dan
slug gambar kualitas yang dihentikan, menghapus baris katalog usang yang dihasilkan, serta memperbaiki
metadata konteks usang pada baris 4.20 aktif. Perintah ini tidak menyematkan alias
beta-latest 4.20 aktif ke snapshot bertanggal.
Fitur
Pencarian web
Pencarian web
Penyedia pencarian web
grok terintegrasi mengutamakan OAuth xAI, lalu menggunakan
XAI_API_KEY atau kunci pencarian web Plugin sebagai cadangan:Pembuatan video
Pembuatan video
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 mendukung1080P; semua mode pembuatan menggunakan480Psecara 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
imageRoleskereference_imageuntuk 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.timeoutMsatauagents.defaults.videoGenerationModel.timeoutMsditetapkan
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:Lihat Pembuatan Video untuk parameter alat bersama,
pemilihan penyedia, dan perilaku failover.
Pembuatan gambar
Pembuatan gambar
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
imageatau hingga tigaimages - 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.timeoutMsatauagents.defaults.imageGenerationModel.timeoutMsditetapkan
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:xAI juga mendokumentasikan
quality, mask, user, dan rasio aspek auto.
Saat ini OpenClaw hanya meneruskan kontrol gambar lintas penyedia bersama;
pengaturan khusus native ini tidak diekspos melalui image_generate.Teks-ke-ucapan
Teks-ke-ucapan
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
OpenClaw menggunakan endpoint batch
/v1/tts xAI untuk sintesis dengan buffer,
penemuan katalog /v1/tts/voices terautentikasi, dan
wss://api.x.ai/v1/tts native untuk sintesis streaming. Streaming dibatasi pada
host api.x.ai native, sehingga nilai baseUrl kustom ditolak pada
jalur ini. Jalur ini menggunakan kontrol bahasa, suara, codec, dan kecepatan yang tersedia;
default xAI berlaku untuk laju sampel dan laju bit. Sintesis berkas audio mematuhi semua
codec yang dikonfigurasi. Target catatan suara menggunakan MP3 untuk streaming dan fallback
dengan buffer karena codec mentah xAI tidak membawa metadata codec/laju. Stream
mengirim text.delta lalu
text.done, menerima audio.delta, audio.done, atau error, dan menerapkan
timeoutMs saat menganggur yang diperbarui untuk setiap potongan audio. Jalur ini terpisah dari
sesi suara waktu nyata. Lihat kontrak API TTS Streaming xAI.Ucapan-ke-teks
Ucapan-ke-teks
Plugin 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.
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
Ucapan-ke-teks streaming
Ucapan-ke-teks streaming
Plugin Konfigurasi milik penyedia berada di bawah
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
plugins.entries.voice-call.config.streaming.providers.xai. Kunci yang didukung
adalah apiKey, baseUrl, sampleRate, encoding (pcm, mulaw, atau
alaw), interimResults, endpointingMs, dan language.Penyedia streaming ini ditujukan untuk jalur transkripsi waktu nyata Panggilan Suara.
Suara Discord merekam segmen pendek dan menggunakan jalur transkripsi batch
tools.media.audio sebagai gantinya.Suara waktu nyata (Bicara)
Suara waktu nyata (Bicara)
Plugin Konfigurasi milik penyedia juga diselesaikan dari
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
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.OAuth xAI atau
XAI_API_KEY dapat mengautentikasi suara waktu nyata. WebRTC yang dimiliki
browser belum menjadi bagian dari permukaan penyedia ini; gunakan Bicara gateway-relay pada
Node native atau jalur relai UI Kontrol.sessionResumption secara default bernilai false. Saat ditetapkan ke true, OpenClaw meminta
xAI mempertahankan status sesi yang cukup untuk melanjutkan percakapan yang sama setelah
tersambung kembali, lalu menyambung kembali dengan ID percakapan yang dikembalikan. Biarkan
dinonaktifkan jika pemutaran ulang/retensi di sisi penyedia tidak dapat diterima; soket yang
terinterupsi kemudian gagal secara tertutup alih-alih diam-diam memulai percakapan baru.Konfigurasi x_search
Konfigurasi x_search
Plugin xAI bawaan mengekspos
x_search sebagai alat OpenClaw untuk
mencari konten X (sebelumnya Twitter) melalui Grok.Jalur konfigurasi: plugins.entries.xai.config.xSearchKonfigurasi eksekusi kode
Konfigurasi eksekusi kode
Plugin xAI bawaan mengekspos
code_execution sebagai alat OpenClaw untuk
eksekusi kode jarak jauh di lingkungan sandbox xAI.Jalur konfigurasi: plugins.entries.xai.config.codeExecutionIni adalah eksekusi sandbox xAI jarak jauh, bukan
exec lokal.Batasan yang diketahui
Batasan yang diketahui
- 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.
qualitygambar xAI,maskgambar, dan rasio aspek tambahan khusus native belum diekspos hingga alat bersamaimage_generatememiliki kontrol lintas penyedia yang sesuai.
Catatan lanjutan
Catatan lanjutan
- OpenClaw menerapkan perbaikan kompatibilitas skema alat dan pemanggilan alat khusus xAI secara otomatis pada jalur runner bersama.
- Permintaan native xAI menggunakan
tool_stream: truesecara default. Aturagents.defaults.models["xai/<model>"].params.tool_streamkefalseuntuk 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, dancode_executiondiekspos 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_searchmembacaplugins.entries.xai.config.webSearch.baseUrl.x_searchmembacaplugins.entries.xai.config.xSearch.baseUrl, lalu melakukan fallback ke URL dasar pencarian web Grok. x_searchdancode_executiondimiliki oleh plugin xAI bawaan, bukan di-hardcode ke dalam runtime model inti.code_executionadalah eksekusi sandbox xAI jarak jauh, bukanexeclokal.
Pengujian langsung
Jalur media xAI dicakup oleh pengujian unit dan rangkaian pengujian langsung yang harus diaktifkan secara eksplisit. EksporXAI_API_KEY di lingkungan proses sebelum menjalankan pemeriksaan langsung.
Terkait
Pemilihan model
Memilih penyedia, referensi model, dan perilaku failover.
Pembuatan video
Parameter alat video bersama dan pemilihan penyedia.
Semua penyedia
Ikhtisar penyedia yang lebih luas.
Pemecahan masalah
Masalah umum dan perbaikannya.