Esecuzione di codice

code_execution esegue analisi Python remote in sandbox sull'API Responses di xAI. È registrato dal plugin xai in bundle (sotto il contratto tools) e inoltra le richieste allo stesso endpoint https://api.x.ai/v1/responses usato da x_search.

È diverso da exec locale:

• exec esegue comandi shell sulla tua macchina o sul node associato.
• code_execution esegue Python nel sandbox remoto di xAI.

Usa code_execution per:

• Calcoli.
• Tabulazione.
• Statistiche rapide.
• Analisi in stile grafico.
• Analizzare dati restituiti da x_search o web_search.

Non usarlo quando hai bisogno di file locali, della tua shell, del tuo repo o di dispositivi associati. Usa exec per quello.

Configurazione

export XAI_API_KEY=xai-...

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

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast", // sovrascrive il modello di esecuzione codice xAI predefinito            maxTurns: 2,            // limite opzionale sui turni interni dello strumento            timeoutSeconds: 30,     // timeout della richiesta (predefinito: 30)          },        },      },    },  },}

openclaw gateway restart

Come usarlo

Chiedi in modo naturale e rendi esplicito l'obiettivo dell'analisi:

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.

Lo strumento accetta internamente un singolo parametro task, quindi l'agente deve inviare la richiesta di analisi completa e tutti i dati inline in un unico prompt.

Errori

Quando lo strumento viene eseguito senza autenticazione, restituisce un errore strutturato missing_xai_api_key che punta al profilo di autenticazione, alla variabile di ambiente e alle opzioni di configurazione. L'errore è JSON, non un'eccezione generata, quindi l'agente può correggersi autonomamente:

{  "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"}

Limiti

• Questa è esecuzione remota xAI, non esecuzione di processi locali.
• Considera i risultati come analisi effimera, non come una sessione notebook persistente.
• Non presumere l'accesso a file locali o al tuo workspace.
• Per dati X aggiornati, usa prima x_search e passa il risultato a code_execution.

Correlati