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 oder 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, anschließend eine eingebettete Umgebungs-SecretRef für baseUrl, danach SEARXNG_BASE_URL. Wenn keiner der Konfigurationspfade festgelegt ist, SEARXNG_BASE_URL vorhanden ist und kein Provider ausdrücklich ausgewählt wurde, wählt die automatische Erkennung SearXNG aus.

Referenz der Plugin-Konfiguration

Der web_search-Toolaufruf akzeptiert außerdem count (1–10 Ergebnisse), categories und language als Überschreibungen für den jeweiligen Aufruf.

Hinweise

• JSON-API -- verwendet den nativen format=json-Endpunkt von SearXNG anstelle von HTML-Scraping
• URLs von Bildergebnissen -- Ergebnisse der Bildkategorie enthalten img_src, wenn SearXNG eine direkte Bild-URL zurückgibt
• Kein API-Schlüssel -- funktioniert sofort 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 Host oder local 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 Systeme, während für https://-Basis-URLs, die öffentlich aufgelöst werden, ein strenger SSRF-Schutz bestehen bleibt
• Reihenfolge der automatischen Erkennung -- SearXNG erfordert eine konfigurierte baseUrl (Rang 200 unter Providern, die bereits über die erforderlichen Anmeldedaten verfügen). Schlüsselfreie Provider wie DuckDuckGo oder Ollama Web Search werden bei der automatischen Erkennung niemals implizit ausgewählt; sie werden nur durch eine ausdrückliche provider-Auswahl aktiviert
• Selbst gehostet -- Sie kontrollieren die Instanz, die Abfragen und die vorgeschalteten Suchmaschinen
• Kategorien verwenden standardmäßig general, wenn sie nicht konfiguriert sind
• Kategorie-Fallback -- wenn eine Anfrage für eine andere Kategorie als 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 Abfrage, Anzahl, Kategorien, Sprache und Basis-URL) werden prozessintern für eine kurze TTL zwischengespeichert
• Versionsanforderung -- das Plugin deklariert minHostVersion: >=2026.6.9

Verwandte Themen

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