Tools
Codeausführung
code_execution führt isolierte Remote-Python-Analysen ü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 gemäß dem tools-Vertrag registriert.
| 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 |
| Standardzeitlimit | 30 Sekunden |
Standardwert für maxTurns |
nicht festgelegt (xAI wendet ein eigenes internes Limit an) |
Verwenden Sie es für Berechnungen, Tabellierungen, schnelle Statistiken und diagrammartige
Analysen, einschließlich der von x_search oder web_search zurückgegebenen Daten. Es hat keinen
Zugriff auf lokale Dateien, Ihre Shell, Ihr Repository oder gekoppelte Geräte und speichert
keinen Zustand zwischen Aufrufen. Behandeln Sie daher jeden Aufruf als kurzlebige 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 von Remote-Hosts ohne localhost-Callback funktioniert):
openclaw models auth login --provider xai --method oauthBei einer Neuinstallation ist dieselbe Auswahl beim Onboarding verfügbar:
openclaw onboard --install-daemon --auth-choice xai-oauthAlternativ mit einem API-Schlüssel:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...Oder über die Konfiguration:
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}Jede dieser drei Optionen versorgt außerdem x_search und Grok web_search.
code_execution aktivieren und anpassen
Wenn enabled weggelassen wird, ist code_execution nur verfügbar, wenn der Provider
des aktiven Modells xai ist und die xAI-Anmeldedaten aufgelöst werden können. Setzen Sie bei einem aktiven Modell
mit einem bekannten Nicht-xAI-Provider
plugins.entries.xai.config.codeExecution.enabled auf true, um die
Provider-übergreifende Nutzung zu aktivieren. Wenn der Provider des aktiven Modells fehlt oder nicht aufgelöst werden kann,
bleibt das Tool ausgeblendet. Setzen Sie enabled auf false, um es für jeden
Provider zu deaktivieren. xAI-Anmeldedaten sind immer erforderlich.
Verwenden Sie denselben Block, um das Modell, das Aufruflimit oder das Zeitlimit 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-Aufrufe timeoutSeconds: 30, // Anfragezeitlimit (Standard: 30) }, }, }, }, },}Gateway neu starten
openclaw gateway restartcode_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 bestanden sind.
Verwendung
Formulieren Sie die beabsichtigte Analyse ausdrücklich. Das Tool akzeptiert einen einzigen Parameter task.
Senden Sie daher die vollständige Anfrage und alle eingebetteten Daten in einem Prompt:
Verwenden Sie code_execution, um den gleitenden 7-Tage-Durchschnitt für diese Zahlen zu berechnen: ...Verwenden Sie x_search, um Beiträge zu finden, die diese Woche OpenClaw erwähnen, und anschließend code_execution, um sie nach Tag zu zählen.Verwenden Sie web_search, um die neuesten Zahlen zu KI-Benchmarks zu sammeln, und anschließend code_execution, um die prozentualen Änderungen zu vergleichen.Fehler
Ohne Authentifizierung gibt das Tool einen strukturierten JSON-Fehler zurück (keine ausgelöste Ausnahme), 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"}