xAI

Anche il provider di ricerca web grok incluso usa XAI_API_KEY:

openclaw config set tools.web.search.provider grok

Il Plugin xai incluso registra la generazione video tramite lo strumento condiviso video_generate.

• Modello video predefinito: xai/grok-imagine-video
• Modalità: text-to-video, image-to-video, generazione reference-image, modifica video remota ed estensione video remota
• Proporzioni: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Risoluzioni: 480P, 720P
• Durata: 1-15 secondi per generazione/image-to-video, 1-10 secondi quando si usano ruoli reference_image, 2-10 secondi per l'estensione
• Generazione reference-image: imposta imageRoles su reference_image per ogni immagine fornita; xAI accetta fino a 7 immagini di questo tipo

Per usare xAI come provider video predefinito:

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

Il Plugin xai incluso registra la generazione immagini tramite lo strumento condiviso image_generate.

• Modello immagine predefinito: xai/grok-imagine-image
• Modello aggiuntivo: xai/grok-imagine-image-pro
• Modalità: text-to-image e modifica reference-image
• Input di riferimento: una image o fino a cinque images
• Proporzioni: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Risoluzioni: 1K, 2K
• Conteggio: fino a 4 immagini

OpenClaw richiede a xAI risposte immagine b64_json in modo che i media generati possano essere archiviati e consegnati tramite il normale percorso degli allegati del canale. Le immagini di riferimento locali vengono convertite in URL di dati; i riferimenti http(s) remoti vengono inoltrati.

Per usare xAI come provider immagine predefinito:

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

Il Plugin xai incluso registra la sintesi vocale tramite la superficie provider tts condivisa.

• Voci: eve, ara, rex, sal, leo, una
• Voce predefinita: eve
• Formati: mp3, wav, pcm, mulaw, alaw
• Lingua: codice BCP-47 o auto
• Velocità: override della velocità nativo del provider
• Il formato nativo per note vocali Opus non è supportato

Per usare xAI come provider TTS predefinito:

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

Il Plugin xai incluso registra il riconoscimento vocale batch tramite la superficie di trascrizione per comprensione dei media di OpenClaw.

• Modello predefinito: grok-stt
• Endpoint: REST xAI /v1/stt
• Percorso input: caricamento file audio multipart
• Supportato da OpenClaw ovunque la trascrizione audio in ingresso usi tools.media.audio, inclusi segmenti di canali vocali Discord e allegati audio dei canali

Per forzare xAI per la trascrizione audio in ingresso:

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

La lingua può essere fornita tramite la configurazione audio media condivisa o per singola richiesta di trascrizione. Gli indizi di prompt sono accettati dalla superficie condivisa di OpenClaw, ma l'integrazione STT REST di xAI inoltra solo file, modello e lingua perché questi si mappano chiaramente sull'attuale endpoint pubblico xAI.

Il Plugin xai incluso registra anche un provider di trascrizione in tempo reale per l'audio delle chiamate vocali live.

• Endpoint: WebSocket xAI wss://api.x.ai/v1/stt
• Codifica predefinita: mulaw
• Frequenza di campionamento predefinita: 8000
• Endpointing predefinito: 800ms
• Trascrizioni intermedie: abilitate per impostazione predefinita

Il flusso multimediale Twilio di Voice Call invia frame audio G.711 µ-law, quindi il provider xAI può inoltrare quei frame direttamente senza transcodifica:

{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "xai",
            providers: {
              xai: {
                apiKey: "${XAI_API_KEY}",
                endpointingMs: 800,
                language: "en",
              },
            },
          },
        },
      },
    },
  },
}

La configurazione di proprietà del provider si trova in plugins.entries.voice-call.config.streaming.providers.xai. Le chiavi supportate sono apiKey, baseUrl, sampleRate, encoding (pcm, mulaw o alaw), interimResults, endpointingMs e language.

Il plugin xAI incluso espone x_search come strumento OpenClaw per cercare contenuti X (precedentemente Twitter) tramite Grok.

Percorso di configurazione: 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,
          },
        },
      },
    },
  },
}

Il plugin xAI incluso espone code_execution come strumento OpenClaw per l'esecuzione remota del codice nell'ambiente sandbox di xAI.

Percorso di configurazione: plugins.entries.xai.config.codeExecution

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

• L'autenticazione oggi avviene solo tramite chiave API. Non esiste ancora in OpenClaw un flusso OAuth xAI o con codice dispositivo.
• grok-4.20-multi-agent-experimental-beta-0304 non è supportato nel percorso normale del provider xAI perché richiede una superficie API upstream diversa dal trasporto xAI standard di OpenClaw.
• La voce xAI Realtime non è ancora registrata come provider OpenClaw. Richiede un contratto di sessione vocale bidirezionale diverso da STT batch o dalla trascrizione in streaming.
• quality dell'immagine xAI, mask dell'immagine e ulteriori rapporti d'aspetto solo nativi non sono esposti finché lo strumento condiviso image_generate non avrà controlli cross-provider corrispondenti.

• OpenClaw applica automaticamente correzioni di compatibilità specifiche per xAI allo schema degli strumenti e alle chiamate degli strumenti nel percorso runner condiviso.
• Le richieste xAI native usano per impostazione predefinita tool_stream: true. Imposta agents.defaults.models["xai/<model>"].params.tool_stream su false per disabilitarlo.
• Il wrapper xAI incluso rimuove flag strict dello schema degli strumenti non supportati e chiavi del payload di ragionamento prima di inviare richieste xAI native.
• web_search, x_search e code_execution sono esposti come strumenti OpenClaw. OpenClaw abilita lo specifico built-in xAI necessario dentro ogni richiesta dello strumento invece di collegare tutti gli strumenti nativi a ogni turno di chat.
• Grok web_search legge plugins.entries.xai.config.webSearch.baseUrl. x_search legge plugins.entries.xai.config.xSearch.baseUrl, quindi ripiega sull'URL di base della ricerca web Grok.
• x_search e code_execution sono di proprietà del plugin xAI incluso invece che essere codificati direttamente nel runtime del modello core.
• code_execution è esecuzione remota nella sandbox xAI, non exec locale.