OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

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.

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) :

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

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

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

    Ou avec une clé d’API :

    bash
    openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...

    Ou via la configuration :

    json5
    {  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 :

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

    bash
    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 :

    text
    Utilisez code_execution pour calculer la moyenne mobile sur 7 jours de ces nombres : ...
    text
    Utilisez x_search pour trouver les publications mentionnant OpenClaw cette semaine, puis utilisez code_execution pour les compter par jour.
    text
    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 :

    json
    {  "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.
    Was this useful?
    On this page

    On this page