OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Code-uitvoering

code_execution voert Python-analyses op afstand uit in een sandbox via xAI's Responses API (https://api.x.ai/v1/responses, hetzelfde eindpunt dat x_search gebruikt). Het wordt door de meegeleverde xai-plugin geregistreerd onder het tools-contract.

Eigenschap Waarde
Toolnaam code_execution
Providerplugin xai (meegeleverd, enabledByDefault: true)
Authenticatie xAI-authenticatieprofiel, XAI_API_KEY of plugins.entries.xai.config.webSearch.apiKey
Standaardmodel grok-4.3
Standaardtime-out 30 seconden
Standaard-maxTurns niet ingesteld (xAI past zijn eigen interne limiet toe)

Gebruik het voor berekeningen, tabellen, snelle statistieken en analyses in grafiekvorm, ook voor gegevens die door x_search of web_search zijn geretourneerd. Het heeft geen toegang tot lokale bestanden, je shell, je repository of gekoppelde apparaten en bewaart geen status tussen aanroepen. Beschouw elke aanroep daarom als een tijdelijke analyse, niet als een notebooksessie. Voer voor actuele gegevens van X eerst x_search uit en geef het resultaat door.

Gebruik in plaats daarvan exec voor lokale uitvoering.

Installatie

  • Provide xAI credentials

    OAuth vereist een geschikt SuperGrok- of X Premium-abonnement (verificatie met een apparaatcode, zodat het vanaf externe hosts werkt zonder callback naar localhost):

    bash
    openclaw models auth login --provider xai --method oauth

    Tijdens een nieuwe installatie is dezelfde keuze beschikbaar in de onboarding:

    bash
    openclaw onboard --install-daemon --auth-choice xai-oauth

    Of met een API-sleutel:

    bash
    openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...

    Of via de configuratie:

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

    Elk van deze drie opties voorziet ook x_search en Grok web_search van authenticatie.

  • Enable and tune code_execution

    Als enabled is weggelaten, wordt code_execution alleen beschikbaar gemaakt wanneer de provider van het actieve model xai is en de xAI-inloggegevens kunnen worden gevonden. Stel bij een actief model met een bekende niet-xAI-provider plugins.entries.xai.config.codeExecution.enabled in op true om gebruik met meerdere providers in te schakelen. Als de provider van het actieve model ontbreekt of niet kan worden bepaald, blijft de tool verborgen. Stel enabled in op false om de tool voor elke provider uit te schakelen. xAI-inloggegevens zijn altijd vereist.

    Gebruik hetzelfde blok om het model, de aanroeplimiet of de time-out te overschrijven:

    json5
    {  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true, // required for a known non-xAI model provider            model: "grok-4.3", // override the default xAI code-execution model            maxTurns: 2,            // optional cap on internal tool turns            timeoutSeconds: 30,     // request timeout (default: 30)          },        },      },    },  },}

  • Restart the Gateway

    bash
    openclaw gateway restart

    code_execution verschijnt in de toollijst van de agent zodra de xAI-plugin zich opnieuw registreert en de bovenstaande controles voor provider, inschakeling en authenticatie slagen.

    • Gebruik

    Maak het doel van de analyse expliciet. De tool heeft één task-parameter, dus stuur het volledige verzoek en eventuele inlinegegevens in één prompt:

    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.

    Fouten

    Zonder authenticatie retourneert de tool een gestructureerde JSON-fout (en genereert deze geen exception), zodat de agent zichzelf kan corrigeren:

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

    Gerelateerd

    Exec tool

    Lokale shell-uitvoering op je computer of gekoppelde Node.
    Exec approvals

    Beleid voor het toestaan of weigeren van shell-uitvoering.
    Web tools

    web_search, x_search en web_fetch.
    xAI provider

    Grok-modellen, zoeken op het web en X, en configuratie voor code-uitvoering.
    Was this useful?
    On this page

    On this page