> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SearXNG-Suche

OpenClaw unterstützt [SearXNG](https://docs.searxng.org/) 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

<Steps>
  <Step title="Plugin installieren">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/searxng-plugin
    ```
  </Step>

  <Step title="Eine SearXNG-Instanz ausführen">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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](https://docs.searxng.org/).
  </Step>

  <Step title="Konfigurieren">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    # Select "searxng" as the provider
    ```

    Oder legen Sie die Umgebungsvariable fest und lassen Sie sie von der automatischen Erkennung finden:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export SEARXNG_BASE_URL="http://localhost:8888"
    ```
  </Step>
</Steps>

## Konfiguration

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
```

Plugin-Einstellungen für die SearXNG-Instanz:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

| Feld         | Beschreibung                                                   |
| ------------ | -------------------------------------------------------------- |
| `baseUrl`    | Basis-URL Ihrer SearXNG-Instanz (erforderlich)                 |
| `categories` | Kommagetrennte Kategorien wie `general`, `news` oder `science` |
| `language`   | Sprachcode 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

<Tip>
  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.
</Tip>

## Verwandt

* [Web Search overview](/de/tools/web) -- alle Provider und automatische Erkennung
* [DuckDuckGo Search](/de/tools/duckduckgo-search) -- ein weiterer schlüsselfreier Provider
* [Brave Search](/de/tools/brave-search) -- strukturierte Ergebnisse mit kostenlosem Tarif