Exécution de code

code_execution exécute une analyse Python distante en environnement isolé sur l’API Responses de xAI (https://api.x.ai/v1/responses, le même point de terminaison qu’utilise x_search). Il est enregistré par le plugin xai intégré dans le cadre du contrat tools.

code_execution s’exécute sur les serveurs de xAI. xAI facture 5 $ pour 1 000 appels d’outil, auxquels s’ajoutent les jetons d’entrée et de sortie du modèle.

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

Utilisez-le pour les calculs, la mise en tableau, les statistiques rapides et les analyses de type graphique, notamment avec les données renvoyées par x_search ou web_search. Il n’a accès ni aux fichiers locaux, ni à votre shell, ni à votre dépôt, ni aux appareils associés, et il ne conserve aucun état entre les appels. Considérez donc chaque appel comme une analyse éphémère, et non comme une session de notebook. Pour obtenir des données X récentes, exécutez d’abord x_search, puis transmettez-lui le résultat. Pour une exécution locale, utilisez plutôt exec.

Configuration

Fournir les identifiants xAI

OAuth nécessite un abonnement SuperGrok ou X Premium admissible (vérification par code d’appareil, ce qui permet de l’utiliser depuis des hôtes distants sans rappel localhost) :

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

Lors d’une nouvelle installation, le même choix est disponible pendant la configuration initiale :

openclaw onboard --install-daemon --auth-choice xai-oauth

Ou avec une clé d’API :

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-...",
          },
        },
      },
    },
  },
}

Chacune de ces trois méthodes permet également d’utiliser x_search et la fonction web_search de Grok.

Activer et ajuster code_execution

Lorsque enabled est omis, code_execution est exposé uniquement si le fournisseur du modèle actif est xai et que les identifiants xAI peuvent être résolus. Pour un modèle actif dont le fournisseur non-xAI est connu, définissez plugins.entries.xai.config.codeExecution.enabled sur true afin d’activer explicitement l’utilisation entre fournisseurs. Si le fournisseur du modèle actif est absent ou non résolu, l’outil reste masqué. Définissez enabled sur false pour le désactiver pour tous les fournisseurs. Les identifiants xAI sont toujours requis.Utilisez le même bloc pour remplacer le modèle, la limite de tours ou le délai d’expiration :

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true, // requis pour un fournisseur de modèle non-xAI connu
            model: "grok-4.3", // remplace le modèle d’exécution de code xAI par défaut
            maxTurns: 2,            // limite facultative du nombre de tours internes de l’outil
            timeoutSeconds: 30,     // délai d’expiration de la requête (valeur par défaut : 30)
          },
        },
      },
    },
  },
}

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é et que les vérifications ci-dessus concernant le fournisseur, l’activation et l’authentification ont réussi.

Utilisation

Indiquez explicitement l’objectif de l’analyse ; l’outil accepte un seul paramètre task. Envoyez donc la demande complète et toutes les données intégrées dans une seule invite :

Utilisez code_execution pour calculer la moyenne mobile sur 7 jours de ces nombres : ...

Utilisez x_search pour trouver les publications mentionnant OpenClaw cette semaine, puis utilisez code_execution pour les compter par jour.

Utilisez web_search pour recueillir les derniers résultats des benchmarks d’IA, puis utilisez code_execution pour comparer les variations en pourcentage.

Erreurs

Sans authentification, l’outil renvoie une erreur JSON structurée (et non une exception levée), ce qui permet à l’agent de se corriger lui-même :

{
  "error": "missing_xai_api_key",
  "message": "code_execution nécessite des identifiants xAI. Exécutez `openclaw onboard --auth-choice xai-oauth` pour vous connecter avec Grok, exécutez `openclaw onboard --auth-choice xai-api-key`, définissez `XAI_API_KEY` dans l’environnement du Gateway ou configurez `plugins.entries.xai.config.webSearch.apiKey`.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

Contenu associé

Outil Exec

Exécution locale du shell sur votre machine ou un Node associé.

Approbations Exec

Politique d’autorisation ou de refus pour l’exécution du shell.

Outils web

web_search, x_search et web_fetch.

Fournisseur xAI

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

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Exécution de code

Configuration

Utilisation

Erreurs

Contenu associé

Outil Exec

Approbations Exec

Outils web

Fournisseur xAI

​Configuration

​Utilisation

​Erreurs

​Contenu associé

Outil Exec

Approbations Exec

Outils web

Fournisseur xAI

Configuration

Utilisation

Erreurs

Contenu associé