xAI

Penyedia pencarian web grok bawaan juga menggunakan XAI_API_KEY:

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 reference-image, pengeditan 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 reference-image: tetapkan imageRoles ke reference_image untuk setiap gambar yang diberikan; 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 pengeditan 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

OpenClaw meminta respons gambar b64_json dari xAI agar media yang dihasilkan dapat disimpan dan dikirim melalui jalur lampiran channel 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: REST xAI /v1/stt
• Jalur input: unggahan file audio multipart
• Didukung oleh OpenClaw di mana pun transkripsi audio masuk menggunakan tools.media.audio, termasuk segmen channel suara Discord dan lampiran audio channel

Untuk memaksa xAI bagi transkripsi audio masuk:

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

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 file, model, dan bahasa karena ketiganya terpetakan dengan bersih ke endpoint publik xAI saat ini.

Plugin xai bawaan juga mendaftarkan penyedia transkripsi realtime untuk audio voice-call langsung.

• Endpoint: WebSocket xAI 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 provider 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 saat ini hanya menggunakan kunci API. Belum ada alur OAuth xAI atau kode perangkat di OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 tidak didukung pada jalur provider xAI normal karena memerlukan permukaan API upstream yang berbeda dari transport xAI OpenClaw standar.
• Suara xAI Realtime belum terdaftar sebagai provider OpenClaw. 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 sampai alat image_generate bersama memiliki kontrol lintas-provider 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 sebelum mengirim permintaan xAI native.
• web_search, x_search, dan code_execution diekspos sebagai alat OpenClaw. OpenClaw mengaktifkan bawaan xAI tertentu yang diperlukan 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 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.