SearXNG-Suche

OpenClaw unterstützt SearXNG als selbst gehosteten, schlüsselfreien web_search-Provider. SearXNG ist eine quelloffene Metasuchmaschine, die Ergebnisse von Google, Bing, DuckDuckGo und anderen Quellen aggregiert.

Vorteile:

• Kostenlos und unbegrenzt -- kein API-Schlüssel und kein kommerzielles Abonnement erforderlich
• Datenschutz / Air-Gap -- Abfragen verlassen niemals Ihr Netzwerk
• Überall einsetzbar -- keine regionalen Einschränkungen kommerzieller Such-APIs

Einrichtung

openclaw plugins install @openclaw/searxng-plugin

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web# "searxng" als Provider auswählen

export SEARXNG_BASE_URL="http://localhost:8888"

Konfiguration

{  tools: {    web: {      search: {        provider: "searxng",      },    },  },}

Einstellungen auf Plugin-Ebene für die SearXNG-Instanz:

{  plugins: {    entries: {      searxng: {        config: {          webSearch: {            baseUrl: "http://localhost:8888",            categories: "general,news", // optional            language: "en", // optional          },        },      },    },  },}

baseUrl akzeptiert auch ein SecretRef-Objekt (zum Beispiel { source: "env", id: "SEARXNG_BASE_URL" }).

Umgebungsvariable

Legen Sie alternativ zur Konfiguration SEARXNG_BASE_URL fest:

export SEARXNG_BASE_URL="http://localhost:8888"

Auflösungsreihenfolge: konfigurierte baseUrl-Zeichenfolge, dann eine eingebettete Umgebungs-SecretRef in baseUrl, anschließend SEARXNG_BASE_URL. Wenn keiner der Konfigurationspfade festgelegt ist, SEARXNG_BASE_URL vorhanden ist und kein Provider explizit ausgewählt wurde, wählt die automatische Erkennung SearXNG aus.

Referenz der Plugin-Konfiguration

Der Tool-Aufruf web_search akzeptiert außerdem count (1–10 Ergebnisse), categories und language als aufrufspezifische Überschreibungen.

Hinweise

• JSON-API -- verwendet den nativen format=json-Endpunkt von SearXNG und kein HTML-Scraping
• URLs von Bildergebnissen -- Ergebnisse der Bildkategorie enthalten img_src, wenn SearXNG eine direkte Bild-URL zurückgibt
• Kein API-Schlüssel -- funktioniert ohne zusätzliche Konfiguration mit jeder SearXNG-Instanz
• Validierung der Basis-URL -- baseUrl muss eine gültige http://- oder https://- URL sein
• Netzwerkschutz -- http://-Basis-URLs müssen auf einen vertrauenswürdigen privaten oder Loopback-Host verweisen (öffentliche Hosts müssen https:// verwenden); https://-Basis-URLs, die zu einer privaten/internen Adresse aufgelöst werden, erhalten dieselbe Ausnahme für selbst gehostete Instanzen, während https://-Basis-URLs, die öffentlich aufgelöst werden, den strengen SSRF-Schutz beibehalten
• Reihenfolge der automatischen Erkennung -- SearXNG erfordert eine konfigurierte baseUrl (Reihenfolge 200 unter Providern, deren erforderliche Anmeldedaten bereits vorhanden sind). Schlüsselfreie Provider wie DuckDuckGo oder Ollama Web Search werden bei der automatischen Erkennung niemals implizit ausgewählt; sie werden nur durch eine explizite Auswahl von provider aktiviert
• Selbst gehostet -- Sie kontrollieren die Instanz, die Abfragen und die vorgelagerten Suchmaschinen
• Kategorien verwenden standardmäßig general, wenn sie nicht konfiguriert sind
• Kategorie-Fallback -- wenn eine Kategorieanfrage außerhalb von general erfolgreich ist, aber keine Ergebnisse zurückgibt, wiederholt OpenClaw dieselbe Abfrage einmal mit general, bevor eine leere Ergebnismenge zurückgegeben wird
• Ergebnis-Caching -- identische Abfragen (gleiche Suchanfrage, Anzahl, Kategorien, Sprache und Basis-URL) werden für eine kurze TTL prozessintern zwischengespeichert
• Versionsanforderung -- das Plugin deklariert minHostVersion: >=2026.6.9

Verwandte Themen

• Übersicht zur Websuche -- alle Provider und automatische Erkennung
• DuckDuckGo-Suche -- ein weiterer schlüsselfreier Provider
• Brave Search -- strukturierte Ergebnisse mit kostenlosem Tarif