Zum Hauptinhalt springen
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

1

Plugin installieren

openclaw plugins install @openclaw/searxng-plugin
2

Eine SearXNG-Instanz ausführen

docker run -d -p 8888:8080 searxng/searxng
Oder verwenden Sie eine vorhandene SearXNG-Bereitstellung, auf die Sie Zugriff haben. Informationen zur Produktionseinrichtung finden Sie in der SearXNG-Dokumentation.
3

Konfigurieren

openclaw configure --section web
# Select "searxng" as the provider
Oder legen Sie die Umgebungsvariable fest und lassen Sie sie von der automatischen Erkennung finden:
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

FeldBeschreibung
baseUrlBasis-URL Ihrer SearXNG-Instanz (erforderlich)
categoriesKommagetrennte Kategorien wie general, news oder science
languageSprachcode für Ergebnisse wie en, de oder fr

​
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
Damit die SearXNG-JSON-API funktioniert, stellen Sie sicher, dass Ihre SearXNG-Instanz das json- Format in ihrer settings.yml unter search.formats aktiviert hat.

​
Verwandt