Naar hoofdinhoud gaan
code_execution voert sandboxed externe Python-analyse uit op xAI’s Responses API. Het wordt geregistreerd door de gebundelde xai-Plugin (onder het tools-contract) en stuurt door naar hetzelfde https://api.x.ai/v1/responses-eindpunt dat door x_search wordt gebruikt.
EigenschapWaarde
Toolnaamcode_execution
Provider-Pluginxai (gebundeld, enabledByDefault: true)
AuthxAI-authprofiel, XAI_API_KEY, of plugins.entries.xai.config.webSearch.apiKey
Standaardmodelgrok-4-1-fast
Standaardtimeout30 seconden
Standaard maxTurnsniet ingesteld (xAI past zijn eigen interne limiet toe)
Dit is anders dan lokale exec:
  • exec voert shell-opdrachten uit op je machine of gekoppelde Node.
  • code_execution voert Python uit in xAI’s externe sandbox.
Gebruik code_execution voor:
  • Berekeningen.
  • Tabellering.
  • Snelle statistiek.
  • 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.

​
Installatie

1

Provide xAI credentials

Log in met Grok OAuth via een geschikt SuperGrok- of X Premium-abonnement, of sla een API-sleutel op. xAI OAuth gebruikt device-codeverificatie, dus het werkt vanaf externe hosts zonder localhost-callback. OAuth werkt voor code_execution en x_search; XAI_API_KEY of Plugin-webzoekconfiguratie kan ook Grok web_search aandrijven.
openclaw models auth login --provider xai --method oauth
Tijdens een nieuwe installatie zijn dezelfde auth-keuzes beschikbaar in onboarding:
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
Of gebruik een API-sleutel:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
Of via configuratie:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Enable and tune code_execution

code_execution is beschikbaar wanneer xAI-inloggegevens beschikbaar zijn. Stel plugins.entries.xai.config.codeExecution.enabled in op false om het uit te schakelen, of gebruik hetzelfde blok om het model en de timeout af te stemmen.
{
  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 verschijnt in de toollijst van de agent zodra de xAI-Plugin zich opnieuw registreert met enabled: true.

​
Hoe je het gebruikt

Vraag op een natuurlijke manier en maak de analysebedoeling 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 auth wordt uitgevoerd, retourneert deze een gestructureerde missing_xai_api_key-fout die wijst naar het authprofiel, de omgevingsvariabele en de configuratieopties. De fout is JSON, geen gegooide uitzondering, zodat de agent zichzelf kan corrigeren: 
{
  "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"
}

​
Limieten

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

​
Gerelateerd

Exec tool

Lokale shell-uitvoering op je machine of gekoppelde Node.

Exec approvals

Toestaan/weigeren-beleid voor shell-uitvoering.

Web tools

web_search, x_search en web_fetch.

xAI provider

Grok-modellen, web-/x-zoekopdrachten en configuratie voor code-uitvoering.