Exécution de code

code_executionAPI exécute une analyse Python à distance sandboxed sur l’API Responses de xAI. Il est enregistré par le plugin xai fourni (sous le contrat tools) et envoie à la même endpoint https://api.x.ai/v1/responses utilisée par x_search.

Propriété	Valeur
Nom de l’outil	code_execution
Plugin fournisseur	xai (fournni, enabledByDefault: true)
Auth	Profil d’authentification xAI, XAI_API_KEY, ou plugins.entries.xai.config.webSearch.apiKey
Modèle par défaut	grok-4-1-fast
Délai d’expiration par défaut	30 secondes
maxTurns par défaut	non défini (xAI applique sa propre limite interne)

Ceci est différent de exec local :

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

Utilisez code_execution pour :

• Calculs.
• Tableaux.
• Statistiques rapides.
• Analyse de style graphique.
• Analyser les données renvoyées par x_search ou web_search.

N’utilisez pas cet outil 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

1. Fournir les identifiants xAI

   Connectez-vous avec Grok OAuthAPIOAuth à l’aide d’un abonnement SuperGrok ou X Premium éligible, utilisez le flux de code d’appareil compatible à distance, ou stockez une clé API. OAuth fonctionne pour code_execution et x_search ; XAI_API_KEY ou la configuration de recherche web du plugin peut également alimenter le web_search Grok.

   openclaw models auth login --provider xai --method oauth
   openclaw models auth login --provider xai --device-code

   Lors d’une nouvelle installation, les mêmes choix d’authentification sont disponibles dans l’intégration (onboarding) :

   openclaw onboard --install-daemon
   openclaw onboard --install-daemon --auth-choice xai-device-code
   ```API
   
   Ou utilisez une clé API :
   
   ```bash
   openclaw models auth login --provider xai --method api-key
   export XAI_API_KEY=xai-...

   Ou via la configuration :

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

2. Activer et configurer code_execution

   code_execution est disponible lorsque les identifiants xAI sont disponibles. Définissez plugins.entries.xai.config.codeExecution.enabled sur false pour le désactiver, ou utilisez le même bloc pour ajuster le model et le délai d’expiration.

   {
     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)
             },
           },
         },
       },
     },
   }

3. Redémarrer le Gateway

   openclaw gateway restart

   code_execution apparaît dans la liste des outils de l’agent une fois que le plugin xAI s’est réenregistré avec enabled: true.

Comment l’utiliser

Posez des questions de manière naturelle et explicitez l’intention 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 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 les options de profil d’authentification, de variable d’environnement et de configuration. L’erreur est au format JSON, et non une exception levée, afin que l’agent puisse se corriger lui-même :

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, 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 distante sur xAI, et non d’une exécution de processus local.
• Traitez les résultats comme une analyse éphémère, et non comme une session de notebook persistante.
• Ne supposez pas l’accès aux fichiers locaux ou à votre espace de travail.
• Pour des données X fraîches, utilisez d’abord x_search et redirigez le résultat vers code_execution.

Connexes

Outil Exec

Exécution de shell local sur votre machine ou sur un nœud associé.

Approbations Exec

Stratégie d’autorisation/refus pour l’exécution du shell.

Outils Web

web_search, x_search et web_fetch.

provider xAI

Modèles Grok, recherche web/x et configuration de l’exécution de code.