Passer au contenu principal
code_execution exécute une analyse Python distante en bac à sable sur l’API Responses de xAI. Il est enregistré par le plugin xai groupé (dans le cadre du contrat tools) et distribue les requêtes vers le même point de terminaison https://api.x.ai/v1/responses que celui utilisé par x_search.
PropriétéValeur
Nom de l’outilcode_execution
Plugin fournisseurxai (groupé, enabledByDefault: true)
AuthentificationProfil d’authentification xAI, XAI_API_KEY, ou plugins.entries.xai.config.webSearch.apiKey
Modèle par défautgrok-4-1-fast
Délai par défaut30 secondes
maxTurns par défautnon défini (xAI applique sa propre limite interne)
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 mise en tableau.
  • Les statistiques rapides.
  • L’analyse 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 appairés. Utilisez exec pour cela.

​
Configuration

1

Provide xAI credentials

Connectez-vous avec Grok OAuth au moyen d’un abonnement SuperGrok ou X Premium éligible, ou stockez une clé d’API. xAI OAuth utilise la vérification par code d’appareil, ce qui lui permet de fonctionner depuis des hôtes distants sans rappel localhost. OAuth fonctionne pour code_execution et x_search ; XAI_API_KEY ou la configuration de recherche web du plugin peuvent aussi alimenter Grok web_search.
openclaw models auth login --provider xai --method oauth
Lors d’une nouvelle installation, les mêmes choix d’authentification sont disponibles dans l’intégration initiale :
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
Ou utilisez 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-...",
          },
        },
      },
    },
  },
}
2

Enable and tune 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 modèle et le délai.
{
  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

Restart the Gateway

openclaw gateway restart
code_execution apparaît dans la liste d’outils de l’agent une fois que le plugin xAI se réenregistre avec enabled: true.

​
Comment l’utiliser

Formulez votre demande naturellement et explicitez l’intention d’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 pointant vers le profil d’authentification, la variable d’environnement et les options 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 xAI, pas d’une exécution de processus local.
  • 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.

​
Connexe

Exec tool

Exécution shell locale sur votre machine ou votre nœud appairé.

Exec approvals

Politique d’autorisation/refus pour l’exécution shell.

Web tools

web_search, x_search et web_fetch.

xAI provider

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