xAI

Penyedia pencarian web grok bawaan dapat menggunakan XAI_API_KEY atau kunci pencarian web Plugin:

openclaw config set tools.web.search.provider grok

Plugin xai bawaan mendaftarkan pembuatan video melalui alat bersama video_generate.

• Model video default: xai/grok-imagine-video
• Mode: text-to-video, image-to-video, pembuatan gambar referensi, 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 pembuatan/image-to-video, 1-10 detik saat menggunakan peran reference_image, 2-10 detik untuk ekstensi
• Pembuatan gambar referensi: tetapkan imageRoles ke reference_image untuk setiap gambar yang disediakan; xAI menerima hingga 7 gambar seperti itu

Untuk menggunakan xAI sebagai penyedia video default:

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

Plugin xai bawaan mendaftarkan pembuatan gambar melalui alat bersama image_generate.

• Model gambar default: xai/grok-imagine-image
• Model tambahan: xai/grok-imagine-image-pro
• Mode: text-to-image dan edit gambar referensi
• 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

OpenClaw meminta respons gambar b64_json dari xAI agar media yang dibuat dapat disimpan dan dikirim melalui jalur lampiran kanal 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: {          voiceId: "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 bagi 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 STT REST xAI hanya meneruskan file, model, dan bahasa karena ketiganya dipetakan dengan jelas ke endpoint xAI publik saat ini.

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

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

Stream media Twilio 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 config: 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 config: plugins.entries.xai.config.codeExecution

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

• Auth saat ini hanya berbasis API key. API key dapat disimpan dalam profil auth xAI, variabel lingkungan, atau config Plugin; belum ada alur OAuth xAI atau kode perangkat di OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 tidak didukung pada jalur penyedia xAI normal karena memerlukan permukaan API upstream yang berbeda dari transport xAI OpenClaw standar.
• Suara Realtime xAI belum terdaftar sebagai penyedia OpenClaw. Ini memerlukan kontrak sesi suara bidirectional yang berbeda dari STT batch atau transkripsi streaming.
• quality gambar xAI, mask gambar, dan rasio aspek tambahan yang hanya native tidak diekspos sampai alat bersama image_generate memiliki kontrol lintas-penyedia yang sesuai.

• OpenClaw menerapkan perbaikan kompatibilitas tool-schema dan tool-call khusus xAI secara otomatis pada jalur runner bersama.
• Permintaan xAI native menetapkan tool_stream: true secara default. Atur agents.defaults.models["xai/<model>"].params.tool_stream ke false untuk menonaktifkannya.
• Wrapper xAI bawaan menghapus flag tool-schema strict yang tidak didukung dan kunci payload reasoning sebelum mengirim permintaan xAI native.
• web_search, x_search, dan code_execution diekspos sebagai alat OpenClaw. OpenClaw mengaktifkan built-in xAI spesifik yang dibutuhkan di dalam setiap permintaan alat, alih-alih 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.