Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 und kein kommerzielles Abonnement erforderlich
  • Datenschutz / Air-Gap — Abfragen verlassen niemals Ihr Netzwerk
  • Funktioniert überall — keine Regionsbeschränkungen für kommerzielle Such-APIs

​
Einrichtung

1

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. Weitere Informationen zur Produktionseinrichtung finden Sie in der SearXNG-Dokumentation.
2

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 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

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
  • 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 OpenClaw dieselbe Abfrage einmal mit general, bevor ein leeres Ergebnisset zurückgegeben wird
Damit die SearXNG-JSON-API funktioniert, stellen Sie sicher, dass in Ihrer SearXNG-Instanz das Format json in settings.yml unter search.formats aktiviert ist.

​
Verwandte Themen