Pular para o conteúdo principal
code_execution executa análise remota de Python em sandbox na Responses API da xAI. Ele é registrado pelo plugin xai incluído (sob o contrato tools) e despacha para o mesmo endpoint https://api.x.ai/v1/responses usado por x_search.
PropriedadeValor
Nome da ferramentacode_execution
Plugin provedorxai (incluído, enabledByDefault: true)
AuthPerfil de auth da xAI, XAI_API_KEY ou plugins.entries.xai.config.webSearch.apiKey
Modelo padrãogrok-4-1-fast
Tempo-limite padrão30 segundos
maxTurns padrãonão definido (a xAI aplica o próprio limite interno)
Isso é diferente do exec local:
  • exec executa comandos de shell na sua máquina ou nó pareado.
  • code_execution executa Python no sandbox remoto da xAI.
Use code_execution para:
  • Cálculos.
  • Tabulação.
  • Estatísticas rápidas.
  • Análise no estilo de gráficos.
  • Analisar dados retornados por x_search ou web_search.
Não use quando precisar de arquivos locais, do seu shell, do seu repositório ou de dispositivos pareados. Use exec para isso.

​
Configuração

1

Forneça credenciais da xAI

Entre com OAuth do Grok usando uma assinatura SuperGrok ou X Premium qualificada, ou armazene uma chave de API. O OAuth da xAI usa verificação por código de dispositivo, então funciona a partir de hosts remotos sem callback de localhost. OAuth funciona para code_execution e x_search; XAI_API_KEY ou a configuração de pesquisa web do plugin também podem alimentar o web_search do Grok.
openclaw models auth login --provider xai --method oauth
Durante uma instalação nova, as mesmas opções de auth ficam disponíveis dentro do onboarding:
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
Ou use uma chave de API:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
Ou via configuração:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Habilite e ajuste code_execution

code_execution fica disponível quando as credenciais da xAI estão disponíveis. Defina plugins.entries.xai.config.codeExecution.enabled como false para desabilitá-lo, ou use o mesmo bloco para ajustar o modelo e o tempo-limite.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast", // override the default xAI code-execution model
            maxTurns: 2,            // optional cap on internal tool turns
            timeoutSeconds: 30,     // request timeout (default: 30)
          },
        },
      },
    },
  },
}
3

Reinicie o Gateway

openclaw gateway restart
code_execution aparece na lista de ferramentas do agente assim que o plugin xAI se registra novamente com enabled: true.

​
Como usar

Peça naturalmente e deixe explícita a intenção da análise: 
Use code_execution to calculate the 7-day moving average for these numbers: ...

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.
A ferramenta recebe internamente um único parâmetro task, então o agente deve enviar a solicitação completa de análise e quaisquer dados inline em um único prompt.

​
Erros

Quando a ferramenta é executada sem auth, ela retorna um erro estruturado missing_xai_api_key apontando para as opções de perfil de auth, variável de ambiente e configuração. O erro é JSON, não uma exceção lançada, então o agente pode se autocorrigir: 
{
  "error": "missing_xai_api_key",
  "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, run `openclaw onboard --auth-choice xai-api-key`, set `XAI_API_KEY` in the Gateway environment, or configure `plugins.entries.xai.config.webSearch.apiKey`.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

​
Limites

  • Esta é execução remota da xAI, não execução de processo local.
  • Trate os resultados como análise efêmera, não como uma sessão persistente de notebook.
  • Não presuma acesso a arquivos locais ou ao seu workspace.
  • Para dados X recentes, use x_search primeiro e canalize o resultado para code_execution.

​
Relacionados

Ferramenta Exec

Execução de shell local na sua máquina ou nó pareado.

Aprovações de exec

Política de permitir/negar para execução de shell.

Ferramentas Web

web_search, x_search e web_fetch.

Provedor xAI

Modelos Grok, pesquisa web/x e configuração de execução de código.