Tools

Code-uitvoering

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-endpoint dat door x_search wordt gebruikt.

Eigenschap	Waarde
Toolnaam	`code_execution`
Provider-Plugin	`xai` (gebundeld, `enabledByDefault: true`)
Authenticatie	xAI-authprofiel, `XAI_API_KEY`, of `plugins.entries.xai.config.webSearch.apiKey`
Standaardmodel	`grok-4-1-fast`
Standaardtime-out	30 seconden
Standaard `maxTurns`	niet ingesteld (xAI past zijn eigen interne limiet toe)

Dit verschilt van lokale exec:

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

Gebruik code_execution voor:

Berekeningen.
Tabellering.
Snelle statistieken.
Diagramachtige analyse.
Analyse van gegevens die door x_search of web_search zijn teruggegeven.

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

Instellen

Geef een xAI API-sleutel op

Voer openclaw onboard --auth-choice xai-api-key uit voor code_execution en x_search, of stel XAI_API_KEY in / configureer de sleutel onder de xAI Plugin wanneer je ook wilt dat Grok-webzoekopdrachten dezelfde referentie gebruiken:

bash

export XAI_API_KEY=xai-...

Of via configuratie:

json5

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

Schakel code_execution in en stem het af

De tool wordt afgeschermd door plugins.entries.xai.config.codeExecution.enabled. Standaard staat dit uit.

json5

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

Herstart de Gateway

bash

openclaw gateway restart

code_execution verschijnt in de toollijst van de agent zodra de xAI Plugin opnieuw registreert met enabled: true.

Hoe je het gebruikt

Vraag op natuurlijke wijze en maak de analysebedoeling expliciet:

text

Use code_execution to calculate the 7-day moving average for these numbers: ...

text

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

text

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.

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

Fouten

Wanneer de tool zonder authenticatie wordt uitgevoerd, geeft deze een gestructureerde missing_xai_api_key-fout terug die verwijst naar de auth-profile-, env-var- en configuratieopties. De fout is JSON, geen gegooide exception, zodat de agent zichzelf kan corrigeren:

json

{  "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"}

Limieten

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

Gerelateerd

Exec-tool

Lokale shelluitvoering op je machine of gekoppelde node.

Exec-goedkeuringen

Toestaan/weigeren-beleid voor shelluitvoering.

Webtools

web_search, x_search en web_fetch.

xAI-provider

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

Was this useful?