Exécution de code

code_execution exécute une analyse Python distante en bac à sable sur l’API Responses de xAI. Il est enregistré par le Plugin xai fourni (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’outil local exec :

• exec exécute des commandes shell sur votre machine ou votre nœud appairé.
• 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 de 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 appairé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", // remplacer le modèle xAI d’exécution de code par défaut
            maxTurns: 2,            // limite optionnelle des tours d’outil internes
            timeoutSeconds: 30,     // délai de requête (par défaut : 30)
          },
        },
      },
    },
  },
}

openclaw gateway restart

# Comment l’utiliser

Demandez naturellement et rendez l’intention d’analyse explicite :

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 prend en interne un seul paramètre task, donc l’agent doit 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 pointant vers la variable d’environnement et le chemin 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. 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 distante xAI, 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.

# Associés