Tools
Execução de código
code_execution executa análises remotas em Python em sandbox na Responses API da xAI
(https://api.x.ai/v1/responses, o mesmo endpoint usado por x_search). Ele é
registrado pelo plugin xai incluído, conforme o contrato tools.
| Propriedade | Valor |
|---|---|
| Nome da ferramenta | code_execution |
| Plugin do provedor | xai (incluído, enabledByDefault: true) |
| Autenticação | Perfil de autenticação da xAI, XAI_API_KEY ou plugins.entries.xai.config.webSearch.apiKey |
| Modelo padrão | grok-4.3 |
| Tempo limite padrão | 30 segundos |
maxTurns padrão |
não definido (a xAI aplica seu próprio limite interno) |
Use-o para cálculos, tabulação, estatísticas rápidas e análises no estilo de
gráficos, inclusive com dados retornados por x_search ou web_search. Ele não
tem acesso a arquivos locais, ao seu shell, ao seu repositório nem a dispositivos pareados, e
não mantém estado entre chamadas; portanto, trate cada chamada como uma análise efêmera, e não
como uma sessão de notebook. Para obter dados recentes do X, execute primeiro
x_search e encaminhe o resultado.
Para execução local, use exec.
Configuração
Forneça as credenciais da xAI
O OAuth exige uma assinatura elegível do SuperGrok ou X Premium (verificação por código de dispositivo, portanto funciona em hosts remotos sem um callback de localhost):
openclaw models auth login --provider xai --method oauthDurante uma nova instalação, a mesma opção está disponível na integração inicial:
openclaw onboard --install-daemon --auth-choice xai-oauthOu use uma chave de API:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...Ou pela configuração:
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}Qualquer uma dessas três opções também habilita x_search e o web_search do Grok.
Ative e ajuste code_execution
Quando enabled é omitido, code_execution só é disponibilizado quando o provedor
do modelo ativo é xai e as credenciais da xAI são encontradas. Para um modelo ativo
com um provedor conhecido que não seja da xAI, defina
plugins.entries.xai.config.codeExecution.enabled como true para aceitar o
uso entre provedores. Se o provedor do modelo ativo estiver ausente ou não puder ser resolvido,
a ferramenta permanecerá oculta. Defina enabled como false para desativá-la para todos os
provedores. As credenciais da xAI são sempre obrigatórias.
Use o mesmo bloco para substituir o modelo, o limite de turnos ou o tempo limite:
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, // obrigatório para um provedor de modelo conhecido que não seja da xAI model: "grok-4.3", // substitui o modelo padrão de execução de código da xAI maxTurns: 2, // limite opcional de turnos internos da ferramenta timeoutSeconds: 30, // tempo limite da solicitação (padrão: 30) }, }, }, }, },}Reinicie o Gateway
openclaw gateway restartcode_execution aparecerá na lista de ferramentas do agente quando o plugin da xAI
for registrado novamente e as verificações de provedor, ativação e autenticação acima forem aprovadas.
Como usar
Explicite a finalidade da análise; a ferramenta recebe um único parâmetro task,
portanto envie a solicitação completa e todos os dados em linha em um único prompt:
Use code_execution para calcular a média móvel de 7 dias destes números: ...Use x_search para encontrar publicações que mencionem OpenClaw nesta semana e depois use code_execution para contá-las por dia.Use web_search para coletar os números mais recentes de benchmarks de IA e depois use code_execution para comparar as variações percentuais.Erros
Sem autenticação, a ferramenta retorna um erro JSON estruturado (em vez de lançar uma exceção), permitindo que o agente faça a autocorreção:
{ "error": "missing_xai_api_key", "message": "code_execution precisa de credenciais da xAI. Execute `openclaw onboard --auth-choice xai-oauth` para entrar com o Grok, execute `openclaw onboard --auth-choice xai-api-key`, defina `XAI_API_KEY` no ambiente do Gateway ou configure `plugins.entries.xai.config.webSearch.apiKey`.", "docs": "https://docs.openclaw.ai/tools/code-execution"}