Zum Hauptinhalt springen

​
SearXNG-Suche

OpenClaw unterstützt SearXNG als selbst gehosteten, schlüsselfreien web_search-Provider. SearXNG ist eine Open-Source-Meta-Suchmaschine, die Ergebnisse von Google, Bing, DuckDuckGo und anderen Quellen zusammenführt. Vorteile:
  • Kostenlos und unbegrenzt — kein API-Schlüssel oder kommerzielles Abonnement erforderlich
  • Datenschutz / Air-Gap — Abfragen verlassen niemals Ihr Netzwerk
  • Funktioniert überall — keine Regionsbeschränkungen wie bei kommerziellen Such-APIs

​
Einrichtung

1

Eine SearXNG-Instanz ausführen

docker run -d -p 8888:8080 searxng/searxng
Oder verwenden Sie eine bestehende SearXNG-Bereitstellung, auf die Sie Zugriff haben. Siehe die SearXNG-Dokumentation für die Einrichtung in Produktionsumgebungen.
2

Konfigurieren

openclaw configure --section web
# Wählen Sie "searxng" als Provider aus
Oder setzen Sie die env var und lassen Sie die Auto-Erkennung sie finden:
export SEARXNG_BASE_URL="http://localhost:8888"

​
Konfiguration

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
Plugin-spezifische 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 auf loopback akzeptiert
  • öffentliche SearXNG-Hosts müssen https:// verwenden

​
Umgebungsvariable

Setzen Sie SEARXNG_BASE_URL als Alternative zur Konfiguration: 
export SEARXNG_BASE_URL="http://localhost:8888"
Wenn SEARXNG_BASE_URL gesetzt ist und kein expliziter Provider konfiguriert wurde, wählt die Auto-Erkennung SearXNG automatisch aus (mit der niedrigsten Priorität — jeder API-gestützte Provider mit einem Schlüssel gewinnt zuerst).

​
Referenz der Plugin-Konfiguration

FeldBeschreibung
baseUrlBase 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 den nativen Endpunkt format=json von SearXNG, kein HTML-Scraping
  • Kein API-Schlüssel — funktioniert sofort mit jeder SearXNG-Instanz
  • Validierung der Base URL — baseUrl muss eine gültige URL mit http:// oder https:// sein; öffentliche Hosts müssen https:// verwenden
  • Reihenfolge der Auto-Erkennung — SearXNG wird in der Auto-Erkennung zuletzt geprüft (Reihenfolge 200). API-gestützte Provider mit konfigurierten Schlüsseln werden zuerst ausgeführt, dann DuckDuckGo (Reihenfolge 100), dann Ollama Web Search (Reihenfolge 110)
  • Selbst gehostet — Sie kontrollieren die Instanz, Abfragen und Upstream-Suchmaschinen
  • Categories verwendet standardmäßig general, wenn nichts konfiguriert wurde
Damit die SearXNG-JSON-API funktioniert, stellen Sie sicher, dass auf Ihrer SearXNG-Instanz das Format json in der settings.yml unter search.formats aktiviert ist.

​
Verwandt