Websuche

Das Tool web_search durchsucht das Web mit Ihrem konfigurierten Provider und gibt Ergebnisse zurück. Ergebnisse werden pro Abfrage 15 Minuten lang im Cache gespeichert (konfigurierbar).

OpenClaw enthält außerdem x_search für Beiträge auf X (früher Twitter) und web_fetch für leichtgewichtiges Abrufen von URLs. In dieser Phase bleibt web_fetch lokal, während web_search und x_search intern xAI Responses verwenden können.

Schnellstart

openclaw configure --section web

await web_search({ query: "OpenClaw plugin SDK" });

await x_search({ query: "dinner recipes" });

Provider auswählen

Provider-Vergleich

Automatische Erkennung

Native OpenAI-Websuche

Direkte OpenAI-Responses-Modelle verwenden automatisch das gehostete Tool web_search von OpenAI, wenn die OpenClaw-Websuche aktiviert und kein verwalteter Provider festgelegt ist. Dies ist Provider-eigenes Verhalten im gebündelten OpenAI-Plugin und gilt nur für nativen OpenAI-API-Datenverkehr, nicht für OpenAI-kompatible Proxy-Basis-URLs oder Azure-Routen. Setzen Sie tools.web.search.provider auf einen anderen Provider wie brave, um das verwaltete Tool web_search für OpenAI-Modelle beizubehalten, oder setzen Sie tools.web.search.enabled: false, um sowohl die verwaltete Suche als auch die native OpenAI-Suche zu deaktivieren.

Native Codex-Websuche

Codex-fähige Modelle können optional das Provider-native Responses-Tool web_search anstelle der verwalteten Funktion web_search von OpenClaw verwenden.

• Konfigurieren Sie es unter tools.web.search.openaiCodex
• Es wird nur für Codex-fähige Modelle aktiviert (openai-codex/* oder Provider mit api: "openai-codex-responses")
• Verwaltetes web_search gilt weiterhin für Nicht-Codex-Modelle
• mode: "cached" ist die Standardeinstellung und die empfohlene Einstellung
• tools.web.search.enabled: false deaktiviert sowohl verwaltete als auch native Suche

{  tools: {    web: {      search: {        enabled: true,        openaiCodex: {          enabled: true,          mode: "cached",          allowedDomains: ["example.com"],          contextSize: "high",          userLocation: {            country: "US",            city: "New York",            timezone: "America/New_York",          },        },      },    },  },}

Wenn die native Codex-Suche aktiviert ist, das aktuelle Modell aber nicht Codex-fähig ist, behält OpenClaw das normale verwaltete Verhalten von web_search bei.

Netzwerksicherheit

Verwaltete web_search-Provider-Aufrufe verwenden den geschützten Fetch-Pfad von OpenClaw. Für vertrauenswürdige Provider-API-Hosts erlaubt OpenClaw Surge-, Clash- und sing-box-Fake-IP- DNS-Antworten in 198.18.0.0/15 und fc00::/7 nur für diesen Provider-Hostnamen. Andere private, loopback-, link-local- und Metadaten-Ziele bleiben blockiert.

Diese automatische Zulassung gilt nicht für beliebige web_fetch-URLs. Für web_fetch aktivieren Sie tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange und tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange ausdrücklich nur dann, wenn Ihr vertrauenswürdiger Proxy diese synthetischen Bereiche besitzt.

Websuche einrichten

Provider-Listen in Dokumentation und Einrichtungsabläufen sind alphabetisch sortiert. Die automatische Erkennung verwendet eine separate Prioritätsreihenfolge.

Wenn kein provider festgelegt ist, prüft OpenClaw Provider in dieser Reihenfolge und verwendet den ersten, der bereit ist:

Zuerst API-gestützte Provider:

1. Brave -- BRAVE_API_KEY oder plugins.entries.brave.config.webSearch.apiKey (Reihenfolge 10)
2. MiniMax Search -- MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY oder plugins.entries.minimax.config.webSearch.apiKey (Reihenfolge 15)
3. Gemini -- plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY oder models.providers.google.apiKey (Reihenfolge 20)
4. Grok -- XAI_API_KEY oder plugins.entries.xai.config.webSearch.apiKey (Reihenfolge 30)
5. Kimi -- KIMI_API_KEY / MOONSHOT_API_KEY oder plugins.entries.moonshot.config.webSearch.apiKey (Reihenfolge 40)
6. Perplexity -- PERPLEXITY_API_KEY / OPENROUTER_API_KEY oder plugins.entries.perplexity.config.webSearch.apiKey (Reihenfolge 50)
7. Firecrawl -- FIRECRAWL_API_KEY oder plugins.entries.firecrawl.config.webSearch.apiKey (Reihenfolge 60)
8. Exa -- EXA_API_KEY oder plugins.entries.exa.config.webSearch.apiKey; optional überschreibt plugins.entries.exa.config.webSearch.baseUrl den Exa-Endpunkt (Reihenfolge 65)
9. Tavily -- TAVILY_API_KEY oder plugins.entries.tavily.config.webSearch.apiKey (Reihenfolge 70)

Danach schlüsselfreie Fallbacks:

10. DuckDuckGo -- schlüsselfreier HTML-Fallback ohne Konto oder API-Schlüssel (Reihenfolge 100)
11. Ollama Web Search -- schlüsselfreier Fallback über Ihren konfigurierten lokalen Ollama-Host, wenn er erreichbar und mit ollama signin angemeldet ist; kann die Bearer-Authentifizierung des Ollama-Providers wiederverwenden, wenn der Host sie benötigt, und kann die direkte Suche über https://ollama.com aufrufen, wenn mit OLLAMA_API_KEY konfiguriert (Reihenfolge 110)
12. SearXNG -- SEARXNG_BASE_URL oder plugins.entries.searxng.config.webSearch.baseUrl (Reihenfolge 200)

Wenn kein Provider erkannt wird, fällt es auf Brave zurück (Sie erhalten einen Fehler wegen fehlendem Schlüssel, der Sie zur Konfiguration eines Schlüssels auffordert).

Konfiguration

{  tools: {    web: {      search: {        enabled: true, // default: true        provider: "brave", // or omit for auto-detection        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },    },  },}

Provider-spezifische Konfiguration (API-Schlüssel, Basis-URLs, Modi) liegt unter plugins.entries.<plugin>.config.webSearch.*. Gemini kann außerdem models.providers.google.apiKey und models.providers.google.baseUrl als nachrangige Fallbacks nach seiner dedizierten Websuche-Konfiguration und GEMINI_API_KEY wiederverwenden. Beispiele finden Sie auf den Provider-Seiten.

tools.web.search.provider wird gegen die Websuche-Provider-IDs validiert, die von gebündelten und installierten Plugin-Manifesten deklariert werden. Ein Tippfehler wie "brvae" lässt die Konfigurationsvalidierung fehlschlagen, statt stillschweigend auf automatische Erkennung zurückzufallen. Wenn ein konfigurierter Provider nur veraltete Plugin-Nachweise hat, etwa einen übrig gebliebenen plugins.entries.<plugin>-Block nach der Deinstallation eines Drittanbieter-Plugins, hält OpenClaw den Start robust und meldet eine Warnung, damit Sie das Plugin neu installieren oder openclaw doctor --fix ausführen können, um die veraltete Konfiguration zu bereinigen.

Die Auswahl des Fallback-Providers für web_fetch ist separat:

• wählen Sie ihn mit tools.web.fetch.provider
• oder lassen Sie dieses Feld weg und OpenClaw erkennt automatisch den ersten bereiten Web-Fetch-Provider aus den verfügbaren Anmeldedaten
• nicht sandboxed web_fetch kann installierte Plugin-Provider verwenden, die contracts.webFetchProviders deklarieren; sandboxed Abrufe bleiben auf gebündelte Provider beschränkt
• derzeit ist der gebündelte Web-Fetch-Provider Firecrawl, konfiguriert unter plugins.entries.firecrawl.config.webFetch.*

Wenn Sie während openclaw onboard oder openclaw configure --section web Kimi wählen, kann OpenClaw außerdem nach Folgendem fragen:

• der Moonshot-API-Region (https://api.moonshot.ai/v1 oder https://api.moonshot.cn/v1)
• dem Standardmodell für die Kimi-Websuche (Standard: kimi-k2.6)

Für x_search konfigurieren Sie plugins.entries.xai.config.xSearch.*. Es verwendet dasselbe xAI-Auth-Profil wie Chat oder den von der Grok-Websuche verwendeten XAI_API_KEY bzw. die Plugin-Websuche-Anmeldedaten. Legacy-Konfiguration unter tools.web.x_search.* wird von openclaw doctor --fix automatisch migriert. Wenn Sie während openclaw onboard oder openclaw configure --section web Grok wählen, kann OpenClaw außerdem eine optionale x_search-Einrichtung mit demselben Schlüssel anbieten. Dies ist ein separater Folgeschritt innerhalb des Grok-Pfads, keine separate übergeordnete Auswahl eines Websuche-Providers. Wenn Sie einen anderen Provider wählen, zeigt OpenClaw die x_search-Eingabeaufforderung nicht an.

API-Schlüssel speichern

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "YOUR_KEY", // pragma: allowlist secret          },        },      },    },  },}

export BRAVE_API_KEY="YOUR_KEY"

Tool-Parameter

x_search

x_search fragt X-Beiträge (ehemals Twitter) mithilfe von xAI ab und gibt KI-synthetisierte Antworten mit Quellenangaben zurück. Es akzeptiert natürlichsprachliche Abfragen und optionale strukturierte Filter. OpenClaw aktiviert das integrierte xAI-Tool x_search nur für die Anfrage, die diesen Tool-Aufruf bedient.

x_search-Konfiguration

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast-non-reasoning",            baseUrl: "https://api.x.ai/v1", // optional, overrides webSearch.baseUrl            inlineCitations: false,            maxTurns: 2,            timeoutSeconds: 30,            cacheTtlMinutes: 15,          },          webSearch: {            apiKey: "xai-...", // optional if an xAI auth profile or XAI_API_KEY is set            baseUrl: "https://api.x.ai/v1", // optional shared xAI Responses base URL          },        },      },    },  },}

x_search sendet an <baseUrl>/responses, wenn plugins.entries.xai.config.xSearch.baseUrl gesetzt ist. Wenn dieses Feld weggelassen wird, fällt es auf plugins.entries.xai.config.webSearch.baseUrl, dann auf die Legacy-Einstellung tools.web.search.grok.baseUrl und schließlich auf den öffentlichen xAI-Endpunkt zurück.

x_search-Parameter

x_search-Beispiel

await x_search({  query: "dinner recipes",  allowed_x_handles: ["nytfood"],  from_date: "2026-03-01",});

// Per-post stats: use the exact status URL or status ID when possibleawait x_search({  query: "https://x.com/huntharo/status/1905678901234567890",});

Beispiele

// Basic searchawait web_search({ query: "OpenClaw plugin SDK" }); // German-specific searchawait web_search({ query: "TV online schauen", country: "DE", language: "de" }); // Recent results (past week)await web_search({ query: "AI developments", freshness: "week" }); // Date rangeawait web_search({  query: "climate research",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domain filtering (Perplexity only)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],});

Tool-Profile

Wenn Sie Tool-Profile oder Allowlists verwenden, fügen Sie web_search, x_search oder group:web hinzu:

{  tools: {    allow: ["web_search", "x_search"],    // or: allow: ["group:web"]  (includes web_search, x_search, and web_fetch)  },}

Verwandte Themen

• Web-Abruf -- eine URL abrufen und lesbaren Inhalt extrahieren
• Webbrowser -- vollständige Browserautomatisierung für JS-lastige Websites
• Grok-Suche -- Grok als web_search-Provider
• Ollama-Websuche -- schlüsselfreie Websuche über Ihren Ollama-Host