Execução de código

code_execution executa análise remota de Python em sandbox na API Responses 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.

Isso é diferente do exec local:

• exec executa comandos de shell na sua máquina ou no 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 em estilo de gráfico.
• Analisar dados retornados por x_search ou web_search.

Não use quando você precisar de arquivos locais, seu shell, seu repositório ou dispositivos pareados. Use exec para isso.

# Configuração

export XAI_API_KEY=xai-...

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

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

openclaw gateway restart

# Como usar

Peça de forma natural 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, 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 a variável de ambiente e o caminho de 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 an 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 recentes do X, use x_search primeiro e encaminhe o resultado para code_execution.

# Relacionados