Tools

Grok-Suche

OpenClaw unterstützt Grok als web_search-Provider und verwendet durch xAI webgestützte Antworten, um KI-synthetisierte Antworten zu erzeugen, die auf Live-Suchergebnissen mit Quellenangaben basieren.

Die Grok-Websuche bevorzugt eine bestehende xAI-OAuth-Anmeldung, sofern eine verfügbar ist. Wenn kein OAuth-Profil vorhanden ist, dient derselbe xAI-API-Schlüssel auch dem integrierten x_search-Tool für die Suche nach Beiträgen auf X (ehemals Twitter) und dem code_execution-Tool. Wenn der Schlüssel unter plugins.entries.xai.config.webSearch.apiKey gespeichert wird, kann OpenClaw ihn außerdem als Fallback für den mitgelieferten xAI-Modell-Provider wiederverwenden.

Verwenden Sie für Metriken einzelner X-Beiträge (Reposts, Antworten, Lesezeichen, Aufrufe) x_search mit der exakten 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 bestehendes xAI-OAuth-Profil wiederverwenden, ohne zur Eingabe eines separaten Websuchschlüssels aufzufordern. Ohne OAuth wird ersatzweise die Einrichtung eines xAI-API-Schlüssels verwendet.

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 Websuch-Provider-Auswahl auf oberster Ebene
kann im selben Ablauf optional das Modell x_search festlegen

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

Anmelden oder API-Schlüssel abrufen

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

Einen API-Schlüssel als Fallback verwenden

Rufen Sie einen API-Schlüssel von xAI ab, 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 ihn ü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 der Responses API          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

Alternative 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 die Umgebungsvariablen in ~/.openclaw/.env ab.

Funktionsweise

Grok verwendet durch xAI webgestützte Antworten, um Antworten mit eingebetteten Quellenangaben zu synthetisieren, ähnlich dem Grounding-Ansatz von Gemini mit der Google-Suche.

Unterstützte Parameter

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

Grok verwendet standardmäßig ein Zeitlimit von 60 Sekunden, da webgestützte Suchen mit xAI Responses länger dauern können als der gemeinsame Standardwert von web_search. Überschreiben Sie ihn mit tools.web.search.timeoutSeconds.

Überschreibungen der Basis-URL

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