SearXNG-Suche

OpenClaw unterstützt SearXNG als selbst gehosteten, schlüsselfreien web_search-Provider. SearXNG ist eine Open-Source-Metasuchmaschine, die Ergebnisse aus 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 Ihr Netzwerk nie
• Funktioniert überall -- keine regionalen Einschränkungen durch kommerzielle Such-APIs

Einrichtung

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Select "searxng" as the provider

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

Konfiguration

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

Plugin-Einstellungen für die SearXNG-Instanz:

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

Das Feld baseUrl akzeptiert auch SecretRef-Objekte.

Transportregeln:

• https:// funktioniert für öffentliche oder private SearXNG-Hosts
• http:// wird nur für vertrauenswürdige Hosts in privaten Netzwerken oder Loopback-Hosts akzeptiert
• öffentliche SearXNG-Hosts müssen https:// verwenden
• private/interne Hosts verwenden den selbst gehosteten Netzwerk-Guard; öffentliche https://- Hosts bleiben beim strikten Web-Search-Guard und können nicht auf private Adressen weiterleiten

Umgebungsvariable

Legen Sie SEARXNG_BASE_URL als Alternative zur Konfiguration fest:

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

Wenn SEARXNG_BASE_URL festgelegt ist und kein expliziter Provider konfiguriert wurde, wählt die automatische Erkennung SearXNG automatisch aus (mit der niedrigsten Priorität -- jeder API-gestützte Provider mit einem Schlüssel hat Vorrang).

Plugin-Konfigurationsreferenz

Hinweise

• JSON-API -- verwendet SearXNGs nativen format=json-Endpunkt, kein HTML-Scraping
• URLs für Bildergebnisse -- Ergebnisse der Bildkategorie enthalten img_src, wenn SearXNG eine direkte Bild-URL zurückgibt
• Kein API-Schlüssel -- funktioniert sofort mit jeder SearXNG-Instanz
• Base-URL-Validierung -- baseUrl muss eine gültige http://- oder https://- URL sein; öffentliche Hosts müssen https:// verwenden
• Network Guard -- private/interne SearXNG-Endpunkte aktivieren den Zugriff auf private Netzwerke; öffentliche https://-SearXNG-Endpunkte behalten strikten SSRF- Schutz bei
• Reihenfolge der automatischen Erkennung -- SearXNG wird nach API-gestützten Providern mit konfigurierten Schlüsseln geprüft (Reihenfolge 200). Schlüsselfreie Provider wie DuckDuckGo oder Ollama Web Search werden ohne explizite Provider-Auswahl nicht automatisch ausgewählt
• Selbst gehostet -- Sie kontrollieren die Instanz, Abfragen und vorgelagerten Suchmaschinen
• Kategorien verwenden standardmäßig general, wenn sie nicht konfiguriert sind
• Kategorie-Fallback -- wenn eine Anfrage für eine nicht-general-Kategorie erfolgreich ist, aber null Ergebnisse zurückgibt, versucht OpenClaw dieselbe Abfrage einmal mit general erneut, bevor eine leere Ergebnismenge zurückgegeben wird

Verwandt

• Web Search overview -- alle Provider und automatische Erkennung
• DuckDuckGo Search -- ein weiterer schlüsselfreier Provider
• Brave Search -- strukturierte Ergebnisse mit kostenlosem Tarif