Codeausführung

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

Dies unterscheidet sich von lokalem exec:

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

Verwenden Sie code_execution für:

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

Verwenden Sie es nicht, wenn Sie lokale Dateien, Ihre Shell, Ihr Repository 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", // override the default xAI code-execution model
            maxTurns: 2,            // optional cap on internal tool turns
            timeoutSeconds: 30,     // request timeout (default: 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 Werkzeug verwendet intern einen einzelnen task-Parameter. Daher sollte der Agent die vollständige Analyseanfrage und alle Inline-Daten in einem Prompt senden.

# Fehler

Wenn das Werkzeug ohne Authentifizierung ausgeführt wird, gibt es einen strukturierten missing_xai_api_key-Fehler zurück, der auf die Umgebungsvariable und den Konfigurationspfad 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. Set XAI_API_KEY in the Gateway environment, or configure plugins.entries.xai.config.webSearch.apiKey.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

# Limits

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

# Verwandte Themen