Vai al contenuto principale

​
xAI

OpenClaw include un plugin provider integrato xai per i modelli Grok.

​
Per iniziare

1

Crea una chiave API

Crea una chiave API nella console xAI.
2

Imposta la tua chiave API

Imposta XAI_API_KEY, oppure esegui:
openclaw onboard --auth-choice xai-api-key
3

Scegli un modello

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
OpenClaw usa l’API xAI Responses come trasporto xAI integrato. La stessa XAI_API_KEY può anche alimentare web_search basato su Grok, x_search di prima classe e code_execution remoto. Se memorizzi una chiave xAI sotto plugins.entries.xai.config.webSearch.apiKey, anche il provider di modelli xAI integrato riutilizza quella chiave come fallback. La configurazione di code_execution si trova sotto plugins.entries.xai.config.codeExecution.

​
Catalogo di modelli integrato

OpenClaw include queste famiglie di modelli xAI pronte all’uso:
FamigliaID modello
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
Grok 4grok-4, grok-4-0709
Grok 4 Fastgrok-4-fast, grok-4-fast-non-reasoning
Grok 4.1 Fastgrok-4-1-fast, grok-4-1-fast-non-reasoning
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Grok Codegrok-code-fast-1
Il plugin risolve anche in forward i nuovi ID grok-4* e grok-code-fast* quando seguono la stessa forma API.
grok-4-fast, grok-4-1-fast e le varianti grok-4.20-beta-* sono gli attuali riferimenti Grok con capacità immagine nel catalogo integrato.

​
Mappature della modalità fast

/fast on oppure agents.defaults.models["xai/<model>"].params.fastMode: true riscrive le richieste xAI native come segue:
Modello sorgenteDestinazione modalità fast
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Alias legacy di compatibilità

Gli alias legacy continuano a normalizzarsi agli ID canonici integrati:
Alias legacyID canonico
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
Funzionalità

Il provider integrato grok per la ricerca web usa anch’esso XAI_API_KEY:
openclaw config set tools.web.search.provider grok
Il plugin integrato xai registra la generazione video tramite lo strumento condiviso video_generate.
  • Modello video predefinito: xai/grok-imagine-video
  • Modalità: da testo a video, da immagine a video e flussi remoti di modifica/estensione video
  • Supporta aspectRatio e resolution
I buffer video locali non sono accettati. Usa URL remoti http(s) per input di riferimento video e di modifica.
Per usare xAI come provider video predefinito:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Vedi Generazione video per i parametri condivisi dello strumento, la selezione del provider e il comportamento di failover.
Il plugin xAI integrato espone code_execution come strumento OpenClaw per l’esecuzione remota di codice nell’ambiente sandbox di xAI.Percorso di configurazione: plugins.entries.xai.config.codeExecution
ChiaveTipoPredefinitoDescrizione
enabledbooleantrue (se la chiave è disponibile)Abilita o disabilita l’esecuzione del codice
modelstringgrok-4-1-fastModello usato per le richieste di esecuzione codice
maxTurnsnumber—Numero massimo di turni di conversazione
timeoutSecondsnumber—Timeout della richiesta in secondi
Si tratta di esecuzione remota nella sandbox xAI, non di exec locale.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
          },
        },
      },
    },
  },
}
  • L’autenticazione oggi è solo tramite chiave API. In OpenClaw non esiste ancora un flusso xAI OAuth o device-code.
  • grok-4.20-multi-agent-experimental-beta-0304 non è supportato sul normale percorso del provider xAI perché richiede una diversa superficie API upstream rispetto al trasporto xAI standard di OpenClaw.
  • OpenClaw applica automaticamente correzioni di compatibilità specifiche di xAI per schema degli strumenti e chiamate agli strumenti sul 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 integrato rimuove i flag strict dello schema degli strumenti non supportati e le chiavi di payload reasoning 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 all’interno di ogni richiesta dello strumento invece di allegare tutti gli strumenti nativi a ogni turno di chat.
  • x_search e code_execution sono gestiti dal plugin xAI integrato invece di essere codificati in modo statico nel runtime del modello core.
  • code_execution è esecuzione remota nella sandbox xAI, non exec locale.

​
Correlati

Selezione del modello

Scegliere provider, riferimenti modello e comportamento di failover.

Generazione video

Parametri condivisi dello strumento video e selezione del provider.

Tutti i provider

La panoramica generale dei provider.

Troubleshooting

Problemi comuni e correzioni.