> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 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`-eindpunt dat door `x_search` wordt gebruikt.
| Eigenschap | Waarde |
| -------------------- | -------------------------------------------------------------------------------- |
| Toolnaam | `code_execution` |
| Provider-Plugin | `xai` (gebundeld, `enabledByDefault: true`) |
| Auth | xAI-authprofiel, `XAI_API_KEY`, of `plugins.entries.xai.config.webSearch.apiKey` |
| Standaardmodel | `grok-4-1-fast` |
| Standaardtimeout | 30 seconden |
| Standaard `maxTurns` | niet ingesteld (xAI past zijn eigen interne limiet toe) |
Dit is anders dan lokale [`exec`](/nl/tools/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`](/nl/tools/exec).
## Installatie
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.
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider xai --method oauth
```
Tijdens een nieuwe installatie zijn dezelfde auth-keuzes beschikbaar in
onboarding:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
```
Of gebruik een API-sleutel:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```
Of via configuratie:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...",
},
},
},
},
},
}
```
`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.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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)
},
},
},
},
},
}
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:
```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Use code_execution to calculate the 7-day moving average for these numbers: ...
```
```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.
```
```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:
```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
"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`](/nl/tools/web#x_search) en voer het resultaat door naar `code_execution`.
## Gerelateerd
Lokale shell-uitvoering op je machine of gekoppelde Node.
Toestaan/weigeren-beleid voor shell-uitvoering.
`web_search`, `x_search` en `web_fetch`.
Grok-modellen, web-/x-zoekopdrachten en configuratie voor code-uitvoering.