Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
PropriedadeValor
Nome da ferramentacode_execution
Plugin provedorxai (incluído, enabledByDefault: true)
Autenticaçãoperfil de autenticação xAI, XAI_API_KEY ou plugins.entries.xai.config.webSearch.apiKey
Modelo padrãogrok-4-1-fast
Timeout padrão30 segundos
maxTurns padrãonã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

1

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:
export XAI_API_KEY=xai-...
Ou via configuração:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Habilite e ajuste code_execution

A ferramenta é controlada por plugins.entries.xai.config.codeExecution.enabled. O padrão é desativado.
{
  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 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: 
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 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: 
{
  "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.