Pular para o conteúdo principal

​
xAI

O OpenClaw inclui um plugin provider xai empacotado para modelos Grok.

​
Primeiros passos

1

Crie uma chave de API

Crie uma chave de API no console da xAI.
2

Defina sua chave de API

Defina XAI_API_KEY ou execute:
openclaw onboard --auth-choice xai-api-key
3

Escolha um modelo

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
O OpenClaw usa a API Responses da xAI como transporte xAI empacotado. A mesma XAI_API_KEY também pode alimentar web_search com tecnologia Grok, x_search de primeira classe e code_execution remoto. Se você armazenar uma chave xAI em plugins.entries.xai.config.webSearch.apiKey, o provider de modelo xAI empacotado também reutiliza essa chave como fallback. O ajuste de code_execution fica em plugins.entries.xai.config.codeExecution.

​
Catálogo de modelos builtin

O OpenClaw inclui estas famílias de modelos xAI prontas para uso:
FamíliaIDs de modelo
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
O plugin também resolve encaminhando IDs grok-4* e grok-code-fast* mais novos quando eles seguem o mesmo formato de API.
grok-4-fast, grok-4-1-fast e as variantes grok-4.20-beta-* são as refs Grok com capacidade de imagem atuais no catálogo empacotado.

​
Mapeamentos de modo fast

/fast on ou agents.defaults.models["xai/<model>"].params.fastMode: true reescreve as solicitações nativas da xAI da seguinte forma:
Modelo de origemDestino do modo fast
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Aliases legados de compatibilidade

Aliases legados ainda são normalizados para os IDs canônicos empacotados:
Alias legadoID canônico
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

​
Recursos

O provider de busca na web grok empacotado também usa XAI_API_KEY:
openclaw config set tools.web.search.provider grok
O plugin xai empacotado registra geração de vídeo por meio da ferramenta compartilhada video_generate.
  • Modelo de vídeo padrão: xai/grok-imagine-video
  • Modos: texto para vídeo, imagem para vídeo e fluxos remotos de edição/extensão de vídeo
  • Suporta aspectRatio e resolution
Buffers de vídeo locais não são aceitos. Use URLs remotas http(s) para entradas de referência de vídeo e edição.
Para usar a xAI como provider de vídeo padrão:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Consulte Geração de vídeo para ver parâmetros compartilhados da ferramenta, seleção de provider e comportamento de failover.
O plugin xAI empacotado expõe code_execution como uma ferramenta do OpenClaw para execução remota de código no ambiente sandbox da xAI.Caminho de configuração: plugins.entries.xai.config.codeExecution
ChaveTipoPadrãoDescrição
enabledbooleantrue (se a chave estiver disponível)Habilita ou desabilita code execution
modelstringgrok-4-1-fastModelo usado para solicitações de code execution
maxTurnsnumber—Número máximo de turnos
timeoutSecondsnumber—Timeout da solicitação em segundos
Isto é execução remota em sandbox da xAI, não exec local.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
          },
        },
      },
    },
  },
}
  • A autenticação hoje é apenas por chave de API. Ainda não existe fluxo OAuth nem device-code da xAI no OpenClaw.
  • grok-4.20-multi-agent-experimental-beta-0304 não é compatível no caminho normal do provider xAI porque exige uma superfície de API upstream diferente do transporte xAI padrão do OpenClaw.
  • O OpenClaw aplica automaticamente correções de compatibilidade específicas da xAI para schema de ferramentas e chamadas de ferramenta no caminho compartilhado do runner.
  • Solicitações nativas da xAI usam por padrão tool_stream: true. Defina agents.defaults.models["xai/<model>"].params.tool_stream como false para desabilitá-lo.
  • O wrapper xAI empacotado remove flags estritas de schema de ferramentas não suportadas e chaves de payload de raciocínio antes de enviar solicitações nativas da xAI.
  • web_search, x_search e code_execution são expostos como ferramentas do OpenClaw. O OpenClaw habilita o built-in específico da xAI necessário dentro de cada solicitação da ferramenta em vez de anexar todas as ferramentas nativas a cada turno de chat.
  • x_search e code_execution pertencem ao plugin xAI empacotado, e não ficam codificados diretamente no runtime de modelo core.
  • code_execution é execução remota em sandbox da xAI, não exec local.

​
Relacionado

Seleção de modelo

Como escolher providers, refs de modelo e comportamento de failover.

Geração de vídeo

Parâmetros compartilhados da ferramenta de vídeo e seleção de provider.

Todos os providers

A visão geral mais ampla de providers.

Solução de problemas

Problemas comuns e correções.