Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

code_execution exécute des analyses Python distantes en bac à sable sur l’API Responses de xAI. Il est enregistré par le Plugin xai fourni avec OpenClaw (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.
PropriétéValeur
Nom de l’outilcode_execution
Plugin fournisseurxai (fourni avec OpenClaw, 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’exec local :
  • exec exécute des commandes shell sur votre machine ou sur le nœud associé.
  • 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 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 associés. Utilisez exec pour cela.

​
Configuration

1

Fournir une clé API xAI

Exécutez openclaw onboard --auth-choice xai-api-key pour code_execution et x_search, ou définissez XAI_API_KEY / configurez la clé sous le Plugin xAI lorsque vous voulez aussi que la recherche web Grok utilise le même identifiant :
export XAI_API_KEY=xai-...
Ou via la configuration :
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Activer et régler code_execution

L’outil est contrôlé par plugins.entries.xai.config.codeExecution.enabled. La valeur par défaut est désactivée.
{
  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 d’outils de l’agent une fois que le Plugin xAI se réenregistre avec enabled: true.

​
Comment l’utiliser

Demandez naturellement et explicitez l’objectif 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 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 qui pointe vers le profil d’authentification, la variable d’environnement et les options 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. 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 xAI distante, 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.

​
Liens connexes

Outil Exec

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

Approbations Exec

Politique d’autorisation/refus pour l’exécution 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.