Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
web_search ist ein leichtgewichtiges HTTP-Tool, keine Browser-Automatisierung. Für JS-lastige Websites oder Anmeldungen verwenden Sie den Web Browser. Zum Abrufen einer bestimmten URL verwenden Sie Web Fetch.

​
Schnellstart

1

Choose a provider

Wählen Sie einen Provider aus und schließen Sie alle erforderlichen Einrichtungsschritte ab. Einige Provider sind schlüsselfrei, während andere API-Schlüssel verwenden. Details finden Sie auf den Provider-Seiten unten.
2

Configure

openclaw configure --section web
Dadurch werden der Provider und alle benötigten Zugangsdaten gespeichert. Sie können auch eine Umgebungsvariable setzen (zum Beispiel BRAVE_API_KEY) und diesen Schritt bei API-gestützten Providern überspringen.
3

Use it

Der Agent kann jetzt web_search aufrufen:
await web_search({ query: "OpenClaw plugin SDK" });
Für Beiträge auf X verwenden Sie:
await x_search({ query: "dinner recipes" });

​
Provider auswählen

Brave Search

Strukturierte Ergebnisse mit Snippets. Unterstützt den Modus llm-context sowie Länder-/Sprachfilter. Kostenloser Tarif verfügbar.

DuckDuckGo

Schlüsselfreier Fallback. Kein API-Schlüssel erforderlich. Inoffizielle HTML-basierte Integration.

Exa

Neuronale Suche plus Stichwortsuche mit Inhaltsextraktion (Hervorhebungen, Text, Zusammenfassungen).

Firecrawl

Strukturierte Ergebnisse. Am besten mit firecrawl_search und firecrawl_scrape für tiefgehende Extraktion kombiniert.

Gemini

KI-synthetisierte Antworten mit Zitaten über Google-Search-Grounding.

Grok

KI-synthetisierte Antworten mit Zitaten über xAI-Web-Grounding.

Kimi

KI-synthetisierte Antworten mit Zitaten über Moonshot-Websuche; nicht geerdete Chat-Fallbacks schlagen explizit fehl.

MiniMax Search

Strukturierte Ergebnisse über die Such-API des MiniMax Token Plan.

Ollama Web Search

Suche über einen angemeldeten lokalen Ollama-Host oder die gehostete Ollama-API.

Perplexity

Strukturierte Ergebnisse mit Steuerelementen für Inhaltsextraktion und Domain-Filterung.

SearXNG

Selbst gehostete Metasuche. Kein API-Schlüssel erforderlich. Aggregiert Google, Bing, DuckDuckGo und weitere.

Tavily

Strukturierte Ergebnisse mit Suchtiefe, Themenfilterung und tavily_extract für URL-Extraktion.

​
Provider-Vergleich

ProviderErgebnisstilFilterAPI-Schlüssel
BraveStrukturierte SnippetsLand, Sprache, Zeit, Modus llm-contextBRAVE_API_KEY
DuckDuckGoStrukturierte Snippets—Keiner (schlüsselfrei)
ExaStrukturiert plus extrahiertNeuronaler/Stichwort-Modus, Datum, InhaltsextraktionEXA_API_KEY
FirecrawlStrukturierte SnippetsÜber das Tool firecrawl_searchFIRECRAWL_API_KEY
GeminiKI-synthetisiert plus Zitate—GEMINI_API_KEY
GrokKI-synthetisiert plus Zitate—XAI_API_KEY
KimiKI-synthetisiert plus Zitate; schlägt bei nicht geerdeten Chat-Fallbacks fehl—KIMI_API_KEY / MOONSHOT_API_KEY
MiniMax SearchStrukturierte SnippetsRegion (global / cn)MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN
Ollama Web SearchStrukturierte Snippets—Keiner für angemeldete lokale Hosts; OLLAMA_API_KEY für direkte Suche über https://ollama.com
PerplexityStrukturierte SnippetsLand, Sprache, Zeit, Domains, InhaltslimitsPERPLEXITY_API_KEY / OPENROUTER_API_KEY
SearXNGStrukturierte SnippetsKategorien, SpracheKeiner (selbst gehostet)
TavilyStrukturierte SnippetsÜber das Tool tavily_searchTAVILY_API_KEY

​
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:
  1. DuckDuckGo — schlüsselfreier HTML-Fallback ohne Konto oder API-Schlüssel (Reihenfolge 100)
  2. 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)
  3. 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).
Alle Provider-Schlüsselfelder unterstützen SecretRef-Objekte. Plugin-spezifische SecretRefs unter plugins.entries.<plugin>.config.webSearch.apiKey werden für die gebündelten API-gestützten Websuch-Provider aufgelöst, darunter Brave, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax, Perplexity und Tavily, unabhängig davon, ob der Provider explizit über tools.web.search.provider ausgewählt oder durch automatische Erkennung bestimmt wird. Im Modus der automatischen Erkennung löst OpenClaw nur den Schlüssel des ausgewählten Providers auf — nicht ausgewählte SecretRefs bleiben inaktiv, sodass Sie mehrere Provider konfiguriert halten können, ohne Auflösungskosten für die nicht verwendeten Provider zu zahlen.

​
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

Führen Sie openclaw configure --section web aus oder setzen Sie den Schlüssel direkt:
{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "YOUR_KEY", // pragma: allowlist secret
          },
        },
      },
    },
  },
}

​
Tool-Parameter

ParameterBeschreibung
querySuchanfrage (erforderlich)
countZurückzugebende Ergebnisse (1-10, Standard: 5)
countryISO-Ländercode mit 2 Buchstaben (z. B. “US”, “DE”)
languageISO-639-1-Sprachcode (z. B. “en”, “de”)
search_langSuchsprachcode (nur Brave)
freshnessZeitfilter: day, week, month oder year
date_afterErgebnisse nach diesem Datum (YYYY-MM-DD)
date_beforeErgebnisse vor diesem Datum (YYYY-MM-DD)
ui_langUI-Sprachcode (nur Brave)
domain_filterDomain-Allowlist-/Denylist-Array (nur Perplexity)
max_tokensGesamtes Inhaltsbudget, Standard 25000 (nur Perplexity)
max_tokens_per_pageToken-Limit pro Seite, Standard 2048 (nur Perplexity)
Nicht alle Parameter funktionieren mit allen Providern. Braves llm-context-Modus lehnt ui_lang ab; date_before benötigt außerdem date_after, weil benutzerdefinierte Aktualitätsbereiche von Brave sowohl Start- als auch Enddatum erfordern. Gemini, Grok und Kimi geben eine synthetisierte Antwort mit Quellenangaben zurück. Sie akzeptieren count aus Kompatibilitätsgründen mit dem gemeinsamen Tool, aber es ändert die Form der fundierten Antwort nicht. Gemini unterstützt freshness, date_after und date_before, indem diese in Zeitbereiche für Google-Search-Grounding umgewandelt werden. Perplexity verhält sich genauso, wenn Sie den Kompatibilitätspfad Sonar/OpenRouter verwenden (plugins.entries.perplexity.config.webSearch.baseUrl / model oder OPENROUTER_API_KEY). SearXNG akzeptiert http:// nur für vertrauenswürdige private Netzwerk- oder loopback-Hosts; öffentliche SearXNG-Endpunkte müssen https:// verwenden. Firecrawl und Tavily unterstützen über web_search nur query und count — verwenden Sie ihre dedizierten Tools für erweiterte Optionen.
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.
xAI dokumentiert x_search mit Unterstützung für Keyword-Suche, semantische Suche, Benutzersuche und Thread-Abruf. Für Engagement-Statistiken einzelner Beiträge wie Reposts, Antworten, Lesezeichen oder Aufrufe sollten Sie eine gezielte Abfrage der genauen Beitrags-URL oder Status-ID bevorzugen. Breite Keyword-Suchen können den richtigen Beitrag finden, geben aber möglicherweise weniger vollständige Metadaten pro Beitrag zurück. Ein gutes Muster ist: zuerst den Beitrag lokalisieren, dann eine zweite x_search-Abfrage ausführen, die auf genau diesen Beitrag fokussiert ist.

​
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

ParameterBeschreibung
querySuchanfrage (erforderlich)
allowed_x_handlesErgebnisse auf bestimmte X-Handles beschränken
excluded_x_handlesBestimmte X-Handles ausschließen
from_dateNur Beiträge an oder nach diesem Datum einschließen (YYYY-MM-DD)
to_dateNur Beiträge an oder vor diesem Datum einschließen (YYYY-MM-DD)
enable_image_understandingxAI angehängte Bilder passender Beiträge prüfen lassen
enable_video_understandingxAI angehängte Videos passender Beiträge prüfen lassen

​
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 possible
await x_search({
  query: "https://x.com/huntharo/status/1905678901234567890",
});

​
Beispiele

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

// German-specific search
await web_search({ query: "TV online schauen", country: "DE", language: "de" });

// Recent results (past week)
await web_search({ query: "AI developments", freshness: "week" });

// Date range
await 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