Tools

Grok-Suche

OpenClaw unterstützt Grok als web_search-Provider und nutzt dabei auf dem Web basierende Antworten von xAI, um KI-synthetisierte Antworten zu erzeugen, die durch aktuelle Suchergebnisse mit Quellenangaben gestützt werden.

Die Grok-Websuche bevorzugt eine vorhandene xAI-OAuth-Anmeldung, sofern eine verfügbar ist. Wenn kein OAuth-Profil vorhanden ist, dient derselbe xAI-API-Schlüssel außerdem als Grundlage für das integrierte Tool x_search zur Suche nach Beiträgen auf X (ehemals Twitter) und für das Tool code_execution. Wenn Sie den Schlüssel unter plugins.entries.xai.config.webSearch.apiKey speichern, kann OpenClaw ihn außerdem als Ausweichoption für den gebündelten xAI-Modell-Provider wiederverwenden.

Für beitragsbezogene X-Metriken (Reposts, Antworten, Lesezeichen, Aufrufe) verwenden Sie x_search mit der genauen Beitrags-URL oder Status-ID anstelle einer allgemeinen Suchanfrage.

Onboarding und Konfiguration

Wenn Sie während openclaw onboard oder openclaw configure --section web Grok auswählen, kann OpenClaw ein vorhandenes xAI-OAuth-Profil wiederverwenden, ohne nach einem separaten Schlüssel für die Websuche zu fragen. Ohne OAuth greift es auf die Einrichtung eines xAI-API-Schlüssels zurück.

OpenClaw bietet anschließend einen weiteren Schritt an, um x_search mit denselben xAI-Anmeldedaten zu aktivieren. Dieser zusätzliche Schritt:

wird nur angezeigt, nachdem Sie Grok für web_search ausgewählt haben
ist keine separate Provider-Auswahl für die Websuche auf oberster Ebene
kann optional im selben Ablauf das Modell für x_search festlegen

Überspringen Sie ihn, um x_search später in der Konfiguration zu aktivieren oder zu ändern.

Anmelden oder API-Schlüssel beziehen

xAI OAuth verwenden

Wenn Sie sich bereits während des Onboardings oder der Modellauthentifizierung bei xAI angemeldet haben, wählen Sie Grok als web_search-Provider. Es ist kein separater API-Schlüssel erforderlich:

bash

openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok

API-Schlüssel als Ausweichoption verwenden

Beziehen Sie einen API-Schlüssel von xAI, wenn OAuth nicht verfügbar ist oder Sie bewusst eine schlüsselbasierte Websuchkonfiguration verwenden möchten.

Schlüssel speichern

Legen Sie XAI_API_KEY in der Gateway-Umgebung fest oder konfigurieren Sie den Schlüssel über:

bash

openclaw configure --section web

Konfiguration

json5

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...", // optional, wenn xAI OAuth oder XAI_API_KEY verfügbar ist            baseUrl: "https://api.x.ai/v1", // optionale Überschreibung der Proxy-/Basis-URL für die Responses API          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

Alternativen für Anmeldedaten: openclaw models auth login --provider xai --method oauth, XAI_API_KEY in der Gateway-Umgebung oder plugins.entries.xai.config.webSearch.apiKey. Legen Sie bei einer Gateway-Installation Umgebungsvariablen in ~/.openclaw/.env ab.

Funktionsweise

Grok verwendet auf dem Web basierende Antworten von xAI, um Antworten mit eingebetteten Quellenangaben zu synthetisieren, ähnlich dem Ansatz von Gemini zur Fundierung mit der Google-Suche.

Unterstützte Parameter

Die Grok-Suche unterstützt query. count wird zur Kompatibilität mit dem gemeinsamen web_search akzeptiert, Grok gibt jedoch stets eine einzelne synthetisierte Antwort mit Quellenangaben anstelle einer Liste mit N Ergebnissen zurück. Provider-spezifische Filter werden nicht unterstützt.

Für Grok gilt standardmäßig ein Zeitlimit von 60 Sekunden, da auf dem Web basierende Suchvorgänge mit xAI Responses länger dauern können als das gemeinsame Standardzeitlimit von web_search. Sie können es mit tools.web.search.timeoutSeconds überschreiben.

Überschreiben der Basis-URL

Legen Sie plugins.entries.xai.config.webSearch.baseUrl fest, um die Grok-Websuche über einen vom Betreiber bereitgestellten Proxy oder einen xAI-kompatiblen Responses-Endpunkt zu leiten. OpenClaw sendet Anfragen nach dem Entfernen abschließender Schrägstriche an <baseUrl>/responses. x_search greift auf dieselbe webSearch.baseUrl zurück, sofern plugins.entries.xai.config.xSearch.baseUrl nicht festgelegt ist.