Vai al contenuto principale

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 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.
ProprietàValore
Nome dello strumentocode_execution
Plugin del providerxai (in bundle, enabledByDefault: true)
Autenticazioneprofilo di autenticazione xAI, XAI_API_KEY, o plugins.entries.xai.config.webSearch.apiKey
Modello predefinitogrok-4-1-fast
Timeout predefinito30 secondi
maxTurns predefinitonon impostato (xAI applica il proprio limite interno)
È 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

1

Fornisci una chiave API xAI

Esegui openclaw onboard --auth-choice xai-api-key per code_execution e x_search, oppure imposta XAI_API_KEY / configura la chiave sotto il plugin xAI quando vuoi anche che la ricerca web Grok usi la stessa credenziale:
export XAI_API_KEY=xai-...
Oppure tramite configurazione:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Abilita e configura code_execution

Lo strumento è controllato da plugins.entries.xai.config.codeExecution.enabled. Il valore predefinito è disattivato.
{
  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)
          },
        },
      },
    },
  },
}
3

Riavvia il Gateway

openclaw gateway restart
code_execution compare nell’elenco degli strumenti dell’agente dopo che il plugin xAI si registra di nuovo con enabled: true.

​
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

Strumento exec

Esecuzione shell locale sulla tua macchina o sul node associato.

Approvazioni exec

Criterio di autorizzazione/rifiuto per l’esecuzione shell.

Strumenti web

web_search, x_search e web_fetch.

Provider xAI

Modelli Grok, ricerca web/X e configurazione di esecuzione codice.