SearXNG-Suche

OmeniaClaw 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
• Funktioniert überall -- keine Regionsbeschränkungen für kommerzielle Such-APIs

Einrichtung

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

OmeniaClaw 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 private Netzwerk- oder loopback-Hosts akzeptiert
• öffentliche SearXNG-Hosts müssen https:// verwenden
• private/interne Hosts verwenden den selbst gehosteten Netzwerkschutz; öffentliche https://-Hosts bleiben beim strikten Websuch-Schutz und können nicht auf private Adressen umleiten

Umgebungsvariable

Legen Sie SEARXNG_BASE_URL als Alternative zur Konfiguration fest:

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

Wenn SEARXNG_BASE_URL gesetzt 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 gewinnt zuerst).

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
• Validierung der Basis-URL -- baseUrl muss eine gültige http://- oder https://-URL sein; öffentliche Hosts müssen https:// verwenden
• Netzwerkschutz -- private/interne SearXNG-Endpunkte entscheiden sich für den Zugriff auf private Netzwerke; öffentliche https://-SearXNG-Endpunkte behalten den strikten SSRF-Schutz bei
• Reihenfolge der automatischen Erkennung -- SearXNG wird bei der automatischen Erkennung zuletzt geprüft (Reihenfolge 200). API-gestützte Provider mit konfigurierten Schlüsseln laufen zuerst, dann DuckDuckGo (Reihenfolge 100), dann Ollama Web Search (Reihenfolge 110)
• Selbst gehostet -- Sie kontrollieren die Instanz, Abfragen und vorgelagerten Suchmaschinen
• Kategorien sind standardmäßig general, wenn sie nicht konfiguriert sind
• Kategorie-Fallback -- wenn eine Anfrage für eine nicht-general-Kategorie erfolgreich ist, aber keine Ergebnisse zurückgibt, wiederholt OmeniaClaw dieselbe Abfrage einmal mit general, bevor ein leeres Ergebnisset zurückgegeben wird

Verwandte Themen

• Websuche-Übersicht -- alle Provider und automatische Erkennung
• DuckDuckGo-Suche -- ein weiterer schlüsselfreier Fallback
• Brave Search -- strukturierte Ergebnisse mit kostenloser Stufe