Code-uitvoering

code_execution voert sandboxed externe Python-analyse uit op de Responses API van xAI. Het wordt geregistreerd door de meegeleverde xai-Plugin (onder het tools-contract) en dispatcht naar hetzelfde https://api.x.ai/v1/responses-endpoint dat door x_search wordt gebruikt.

Dit is anders dan lokale exec:

• exec voert shellcommando's uit op je machine of gekoppelde node.
• code_execution voert Python uit in de externe sandbox van xAI.

Gebruik code_execution voor:

• Berekeningen.
• Tabellering.
• Snelle statistieken.
• Analyse in grafiekstijl.
• Het analyseren van gegevens die door x_search of web_search zijn geretourneerd.

Gebruik het niet wanneer je lokale bestanden, je shell, je repo of gekoppelde apparaten nodig hebt. Gebruik daarvoor exec.

# Instellen

export XAI_API_KEY=xai-...

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

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

openclaw gateway restart

# Het gebruiken

Vraag op een natuurlijke manier en maak de analyse-intentie expliciet:

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.

De tool gebruikt intern één task-parameter, dus de agent moet het volledige analyseverzoek en eventuele inline gegevens in één prompt verzenden.

# Fouten

Wanneer de tool zonder authenticatie wordt uitgevoerd, retourneert deze een gestructureerde missing_xai_api_key-fout die naar de omgevingsvariabele en het configpad verwijst. De fout is JSON, geen gegooide exception, zodat de agent zichzelf kan corrigeren:

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an 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"
}

# Limieten

• Dit is externe xAI-uitvoering, geen lokale procesuitvoering.
• Behandel resultaten als vluchtige analyse, niet als een persistente notebooksessie.
• Ga niet uit van toegang tot lokale bestanden of je werkruimte.
• Gebruik voor recente X-gegevens eerst x_search en geef het resultaat door aan code_execution.

# Gerelateerd