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

# Wyszukiwanie SearXNG

OpenClaw obsługuje [SearXNG](https://docs.searxng.org/) jako **samodzielnie hostowanego,
bezkluczowego** dostawcę `web_search`. SearXNG to otwartoźródłowa metawyszukiwarka,
która agreguje wyniki z Google, Bing, DuckDuckGo i innych źródeł.

Zalety:

* **Bezpłatna i bez limitów** -- nie wymaga klucza API ani komercyjnej subskrypcji
* **Prywatność / air-gap** -- zapytania nigdy nie opuszczają Twojej sieci
* **Działa wszędzie** -- brak ograniczeń regionalnych komercyjnych API wyszukiwania

## Konfiguracja

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

  <Step title="Run a SearXNG instance">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    docker run -d -p 8888:8080 searxng/searxng
    ```

    Albo użyj dowolnego istniejącego wdrożenia SearXNG, do którego masz dostęp. Zobacz
    [dokumentację SearXNG](https://docs.searxng.org/) dotyczącą konfiguracji produkcyjnej.
  </Step>

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

    Albo ustaw zmienną środowiskową i pozwól, aby automatyczne wykrywanie ją znalazło:

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

## Konfiguracja

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

Ustawienia na poziomie Plugin dla instancji SearXNG:

```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
          },
        },
      },
    },
  },
}
```

Pole `baseUrl` akceptuje również obiekty SecretRef.

Reguły transportu:

* `https://` działa dla publicznych lub prywatnych hostów SearXNG
* `http://` jest akceptowane tylko dla zaufanych hostów w sieci prywatnej lub hostów loopback
* publiczne hosty SearXNG muszą używać `https://`
* hosty prywatne/wewnętrzne używają strażnika sieci samodzielnie hostowanej; publiczne hosty `https://`
  pozostają objęte ścisłym strażnikiem wyszukiwania w sieci i nie mogą przekierowywać na adresy
  prywatne

## Zmienna środowiskowa

Ustaw `SEARXNG_BASE_URL` jako alternatywę dla konfiguracji:

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

Gdy `SEARXNG_BASE_URL` jest ustawiona i nie skonfigurowano jawnego dostawcy, automatyczne wykrywanie
automatycznie wybiera SearXNG (z najniższym priorytetem -- każdy dostawca oparty na API z
kluczem wygrywa jako pierwszy).

## Dokumentacja konfiguracji Plugin

| Pole         | Opis                                                                         |
| ------------ | ---------------------------------------------------------------------------- |
| `baseUrl`    | Bazowy URL Twojej instancji SearXNG (wymagane)                               |
| `categories` | Kategorie rozdzielone przecinkami, takie jak `general`, `news` lub `science` |
| `language`   | Kod języka wyników, taki jak `en`, `de` lub `fr`                             |

## Uwagi

* **API JSON** -- używa natywnego punktu końcowego SearXNG `format=json`, a nie scrapowania HTML
* **Adresy URL wyników obrazów** -- wyniki z kategorii obrazów zawierają `img_src`, gdy SearXNG
  zwraca bezpośredni adres URL obrazu
* **Brak klucza API** -- działa od razu z dowolną instancją SearXNG
* **Walidacja bazowego URL** -- `baseUrl` musi być prawidłowym adresem URL `http://` lub `https://`;
  hosty publiczne muszą używać `https://`
* **Strażnik sieci** -- prywatne/wewnętrzne punkty końcowe SearXNG jawnie włączają
  dostęp do sieci prywatnej; publiczne punkty końcowe SearXNG `https://` zachowują ścisłą
  ochronę SSRF
* **Kolejność automatycznego wykrywania** -- SearXNG jest sprawdzany po dostawcach opartych na API
  ze skonfigurowanymi kluczami (kolejność 200). Dostawcy bez klucza, tacy jak DuckDuckGo lub
  Ollama Web Search, nie są automatycznie wybierani bez jawnego wyboru dostawcy
* **Samodzielnie hostowane** -- kontrolujesz instancję, zapytania i nadrzędne wyszukiwarki
* **Kategorie** domyślnie mają wartość `general`, gdy nie są skonfigurowane
* **Awaryjna kategoria** -- jeśli żądanie kategorii innej niż `general` powiedzie się, ale
  zwróci zero wyników, OpenClaw ponawia to samo zapytanie raz z `general`
  przed zwróceniem pustego zestawu wyników

<Tip>
  Aby API JSON SearXNG działało, upewnij się, że Twoja instancja SearXNG ma włączony format `json`
  w pliku `settings.yml` pod `search.formats`.
</Tip>

## Powiązane

* [Omówienie wyszukiwania w sieci](/pl/tools/web) -- wszyscy dostawcy i automatyczne wykrywanie
* [DuckDuckGo Search](/pl/tools/duckduckgo-search) -- kolejny dostawca bez klucza
* [Brave Search](/pl/tools/brave-search) -- uporządkowane wyniki z bezpłatnym poziomem