Codeausführung

code_execution führt sandboxed Remote-Python-Analysen über die Responses API von xAI aus. Es wird vom mitgelieferten xai-Plugin (unter dem tools-Contract) registriert und leitet an denselben https://api.x.ai/v1/responses-Endpunkt weiter, den auch x_search verwendet.

Dies unterscheidet sich von lokalem exec:

• exec führt Shell-Befehle auf Ihrem Computer oder gekoppelten Node aus.
• code_execution führt Python in der Remote-Sandbox von xAI aus.

Verwenden Sie code_execution für:

• Berechnungen.
• Tabellierung.
• Schnelle Statistiken.
• Diagrammartige Analysen.
• Analyse von Daten, die von x_search oder web_search zurückgegeben wurden.

Verwenden Sie es nicht, wenn Sie lokale Dateien, Ihre Shell, Ihr Repo oder gekoppelte Geräte benötigen. Verwenden Sie dafür exec.

Einrichtung

export XAI_API_KEY=xai-...

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

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast", // überschreibt das standardmäßige xAI-Code-Execution-Modell            maxTurns: 2,            // optionale Begrenzung interner Tool-Turns            timeoutSeconds: 30,     // Anfrage-Timeout (Standard: 30)          },        },      },    },  },}

openclaw gateway restart

Verwendung

Fragen Sie natürlich und machen Sie die Analyseabsicht explizit:

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.

Das Tool nimmt intern einen einzelnen task-Parameter entgegen, daher sollte der Agent die vollständige Analyseanfrage und alle Inline-Daten in einem Prompt senden.

Fehler

Wenn das Tool ohne Authentifizierung ausgeführt wird, gibt es einen strukturierten missing_xai_api_key-Fehler zurück, der auf das Auth-Profil, die Env-Var und die Konfigurationsoptionen verweist. Der Fehler ist JSON und keine ausgelöste Exception, sodass der Agent sich selbst korrigieren kann:

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

Grenzen

• Dies ist Remote-Ausführung über xAI, keine lokale Prozessausführung.
• Behandeln Sie Ergebnisse als kurzlebige Analyse, nicht als persistente Notebook-Sitzung.
• Gehen Sie nicht davon aus, dass Zugriff auf lokale Dateien oder Ihren Workspace besteht.
• Verwenden Sie für aktuelle X-Daten zuerst x_search und leiten Sie das Ergebnis an code_execution weiter.

Verwandt