Tools

Execução de código

code_execution executa análise Python remota em sandbox na API Responses da xAI. Ele é registrado pelo Plugin xai incluído (sob o contrato tools) e encaminha para o mesmo endpoint https://api.x.ai/v1/responses usado por x_search.

Propriedade	Valor
Nome da ferramenta	`code_execution`
Plugin provedor	`xai` (incluído, `enabledByDefault: true`)
Autenticação	perfil de autenticação xAI, `XAI_API_KEY` ou `plugins.entries.xai.config.webSearch.apiKey`
Modelo padrão	`grok-4-1-fast`
Timeout padrão	30 segundos
`maxTurns` padrão	não definido (a xAI aplica seu próprio limite interno)

Isso é diferente do exec local:

exec executa comandos de shell na sua máquina ou no Node 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, seu shell, seu repositório ou dispositivos pareados. Use exec para isso.

Configuração

Forneça uma chave de API da xAI

Execute openclaw onboard --auth-choice xai-api-key para code_execution e x_search, ou defina XAI_API_KEY / configure a chave no Plugin xAI quando também quiser que a pesquisa web do Grok use a mesma credencial:

bash

export XAI_API_KEY=xai-...

Ou via configuração:

json5

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...",          },        },      },    },  },}

Habilite e ajuste code_execution

A ferramenta é controlada por plugins.entries.xai.config.codeExecution.enabled. O padrão é desativado.

json5

{  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)          },        },      },    },  },}

Reinicie o Gateway

bash

openclaw gateway restart

code_execution aparece na lista de ferramentas do agente quando o Plugin xAI se registra novamente com enabled: true.

Como usar

Peça naturalmente e deixe explícita a intenção da análise:

text

Use code_execution to calculate the 7-day moving average for these numbers: ...

text

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

text

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.

A ferramenta usa internamente um único parâmetro task, portanto o agente deve enviar a solicitação de análise completa e quaisquer dados inline em um único prompt.

Erros

Quando a ferramenta é executada sem autenticação, ela retorna um erro estruturado missing_xai_api_key apontando para as opções de perfil de autenticação, variável de ambiente e configuração. O erro é JSON, não uma exceção lançada, portanto o agente pode se autocorrigir:

json

{  "error": "missing_xai_api_key",  "message": "code_execution needs an xAI API key. 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

Isso é 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 assuma acesso a arquivos locais ou ao seu espaço de trabalho.
Para dados X recentes, use x_search primeiro e encaminhe o resultado para code_execution.

Relacionados

Ferramenta Exec

Execução de shell local na sua máquina ou no Node 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.

Was this useful?