Codeausführung

code_execution führt eine isolierte Remote-Python-Analyse über die Responses API von xAI aus (https://api.x.ai/v1/responses, derselbe Endpunkt, den x_search verwendet). Das Tool wird vom gebündelten xai-Plugin unter dem tools-Vertrag registriert.

code_execution wird auf den Servern von xAI ausgeführt. xAI berechnet $5 pro 1.000 Tool-Aufrufe zuzüglich der Ein- und Ausgabe-Token des Modells.

Eigenschaft	Wert
Tool-Name	`code_execution`
Provider-Plugin	`xai` (gebündelt, `enabledByDefault: true`)
Authentifizierung	xAI-Authentifizierungsprofil, `XAI_API_KEY` oder `plugins.entries.xai.config.webSearch.apiKey`
Standardmodell	`grok-4.3`
Standard-Timeout	30 Sekunden
Standardwert für `maxTurns`	nicht festgelegt (xAI wendet ein eigenes internes Limit an)

Verwenden Sie das Tool für Berechnungen, Tabellierungen, schnelle Statistiken und diagrammartige Analysen, einschließlich Daten, die von x_search oder web_search zurückgegeben werden. Es hat keinen Zugriff auf lokale Dateien, Ihre Shell, Ihr Repository oder gekoppelte Geräte und speichert zwischen Aufrufen keinen Zustand. Behandeln Sie daher jeden Aufruf als temporäre Analyse und nicht als Notebook-Sitzung. Führen Sie für aktuelle X-Daten zuerst x_search aus und leiten Sie das Ergebnis weiter. Verwenden Sie für die lokale Ausführung stattdessen exec.

Einrichtung

xAI-Anmeldedaten bereitstellen

OAuth erfordert ein berechtigtes SuperGrok- oder X-Premium-Abonnement (Verifizierung per Gerätecode, sodass es auf Remote-Hosts ohne localhost-Callback funktioniert):

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

Bei einer Neuinstallation ist dieselbe Auswahl beim Onboarding verfügbar:

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

Alternativ mit einem API-Schlüssel:

openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...

Oder über die Konfiguration:

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

Jede dieser drei Optionen stellt außerdem die Funktionalität für x_search und Grok web_search bereit.

code_execution aktivieren und abstimmen

Wenn enabled nicht angegeben ist, wird code_execution nur bereitgestellt, wenn der Provider des aktiven Modells xai ist und die xAI-Anmeldedaten aufgelöst werden können. Legen Sie bei einem aktiven Modell mit einem bekannten Nicht-xAI-Provider plugins.entries.xai.config.codeExecution.enabled auf true fest, um die providerübergreifende Verwendung zu aktivieren. Wenn der Provider des aktiven Modells fehlt oder nicht aufgelöst werden kann, bleibt das Tool ausgeblendet. Legen Sie enabled auf false fest, um es für jeden Provider zu deaktivieren. xAI-Anmeldedaten sind immer erforderlich.Verwenden Sie denselben Block, um das Modell, das Rundenlimit oder den Timeout zu überschreiben:

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true, // für einen bekannten Nicht-xAI-Modell-Provider erforderlich
            model: "grok-4.3", // überschreibt das standardmäßige xAI-Modell für die Codeausführung
            maxTurns: 2,            // optionales Limit für interne Tool-Runden
            timeoutSeconds: 30,     // Anfrage-Timeout (Standard: 30)
          },
        },
      },
    },
  },
}

Gateway neu starten

openclaw gateway restart

code_execution erscheint in der Tool-Liste des Agenten, sobald sich das xAI-Plugin erneut registriert und die obigen Prüfungen für Provider, Aktivierung und Authentifizierung erfolgreich sind.

Verwendung

Formulieren Sie die beabsichtigte Analyse ausdrücklich. Das Tool akzeptiert einen einzelnen Parameter task. Senden Sie daher die vollständige Anfrage und alle eingebetteten Daten in einem Prompt:

Verwende code_execution, um den gleitenden 7-Tage-Durchschnitt für diese Zahlen zu berechnen: ...

Verwende x_search, um Beiträge zu finden, in denen OpenClaw diese Woche erwähnt wird, und anschließend code_execution, um sie nach Tagen zu zählen.

Verwende web_search, um die neuesten KI-Benchmarkwerte zusammenzutragen, und anschließend code_execution, um die prozentualen Änderungen zu vergleichen.

Fehler

Ohne Authentifizierung gibt das Tool einen strukturierten JSON-Fehler zurück (und löst keine Ausnahme aus), sodass der Agent den Fehler selbst korrigieren kann:

{
  "error": "missing_xai_api_key",
  "message": "code_execution benötigt xAI-Anmeldedaten. Führen Sie `openclaw onboard --auth-choice xai-oauth` aus, um sich bei Grok anzumelden, führen Sie `openclaw onboard --auth-choice xai-api-key` aus, legen Sie `XAI_API_KEY` in der Gateway-Umgebung fest oder konfigurieren Sie `plugins.entries.xai.config.webSearch.apiKey`.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

Exec-Tool

Lokale Shell-Ausführung auf Ihrem Computer oder einer gekoppelten Node.

Exec-Genehmigungen

Richtlinie zum Zulassen oder Ablehnen der Shell-Ausführung.

Web-Tools

web_search, x_search und web_fetch.

xAI-Provider

Grok-Modelle, Web-/X-Suche und Konfiguration der Codeausführung.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Einrichtung

Verwendung

Fehler

Verwandte Themen

Exec-Tool

Exec-Genehmigungen

Web-Tools

xAI-Provider

​Einrichtung

​Verwendung

​Fehler

​Verwandte Themen

Exec-Tool

Exec-Genehmigungen

Web-Tools

xAI-Provider

Einrichtung

Verwendung

Fehler

Verwandte Themen