Exécution de code

code_execution exécute des analyses Python distantes en bac à sable sur l’API Responses de xAI. Il est enregistré par le Plugin xai fourni avec OpenClaw (sous le contrat tools) et envoie les requêtes au même point de terminaison https://api.x.ai/v1/responses que celui utilisé par x_search.

C’est différent de l’exec local :

• exec exécute des commandes shell sur votre machine ou sur le nœud associé.
• code_execution exécute Python dans le bac à sable distant de xAI.

Utilisez code_execution pour :

• Les calculs.
• La tabulation.
• Les statistiques rapides.
• Les analyses de type graphique.
• L’analyse des données renvoyées par x_search ou web_search.

Ne l’utilisez pas lorsque vous avez besoin de fichiers locaux, de votre shell, de votre dépôt ou d’appareils associés. Utilisez exec pour cela.

Configuration

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

Comment l’utiliser

Demandez naturellement et explicitez l’objectif de l’analyse :

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.

L’outil accepte en interne un seul paramètre task, l’agent doit donc envoyer la demande d’analyse complète et toutes les données en ligne dans une seule invite.

Erreurs

Lorsque l’outil s’exécute sans authentification, il renvoie une erreur structurée missing_xai_api_key qui pointe vers le profil d’authentification, la variable d’environnement et les options de configuration. L’erreur est du JSON, pas une exception levée, ce qui permet à l’agent de s’autocorriger :

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

• Il s’agit d’une exécution xAI distante, pas d’une exécution de processus locale.
• Traitez les résultats comme une analyse éphémère, pas comme une session de notebook persistante.
• Ne supposez pas l’accès aux fichiers locaux ni à votre espace de travail.
• Pour des données X récentes, utilisez d’abord x_search, puis transmettez le résultat à code_execution.

Liens connexes