---
read_when:
    - Вам потрібен самостійно розгорнутий постачальник вебпошуку
    - Ви хочете використовувати SearXNG для web_search
    - Вам потрібен варіант пошуку, орієнтований на конфіденційність або ізольований від мережі
summary: Вебпошук SearXNG -- самостійно розгорнутий провайдер метапошуку без ключа
title: Пошук SearXNG
x-i18n:
    generated_at: "2026-05-02T07:31:33Z"
    model: gpt-5.5
    provider: openai
    source_hash: b9be62f7398379e1672ea7e934a571a529cac07dc5d880ac74e51f8445594034
    source_path: tools/searxng-search.md
    workflow: 16
---

OpenClaw підтримує [SearXNG](https://docs.searxng.org/) як **самостійно розгорнутий,
без ключа** провайдер `web_search`. SearXNG — це метапошуковий рушій із відкритим кодом,
який агрегує результати з Google, Bing, DuckDuckGo та інших джерел.

Переваги:

- **Безкоштовно й без обмежень** -- не потрібен API-ключ або комерційна підписка
- **Конфіденційність / ізоляція мережі** -- запити ніколи не залишають вашу мережу
- **Працює будь-де** -- немає регіональних обмежень комерційних пошукових API

## Налаштування

<Steps>
  <Step title="Run a SearXNG instance">
    ```bash
    docker run -d -p 8888:8080 searxng/searxng
    ```

    Або використайте будь-яке наявне розгортання SearXNG, до якого маєте доступ. Див.
    [документацію SearXNG](https://docs.searxng.org/) для налаштування у продакшені.

  </Step>
  <Step title="Configure">
    ```bash
    openclaw configure --section web
    # Select "searxng" as the provider
    ```

    Або задайте змінну середовища й дозвольте автовиявленню знайти її:

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

  </Step>
</Steps>

## Конфігурація

```json5
{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
```

Налаштування рівня Plugin для екземпляра SearXNG:

```json5
{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}
```

Поле `baseUrl` також приймає об'єкти SecretRef.

Правила транспорту:

- `https://` працює для публічних або приватних хостів SearXNG
- `http://` приймається лише для довірених хостів приватної мережі або loopback
- публічні хости SearXNG мають використовувати `https://`
- приватні/внутрішні хости використовують мережевий захист для самостійно розгорнутих середовищ; публічні хости `https://`
  залишаються під суворим захистом вебпошуку й не можуть переспрямовувати на приватні
  адреси

## Змінна середовища

Задайте `SEARXNG_BASE_URL` як альтернативу конфігурації:

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

Коли `SEARXNG_BASE_URL` задано й явний провайдер не налаштовано, автовиявлення
автоматично вибирає SearXNG (з найнижчим пріоритетом -- будь-який API-backed провайдер із
ключем перемагає першим).

## Довідник конфігурації Plugin

| Поле         | Опис                                                               |
| ------------ | ------------------------------------------------------------------ |
| `baseUrl`    | Базовий URL вашого екземпляра SearXNG (обов'язково)                |
| `categories` | Категорії, розділені комами, як-от `general`, `news` або `science` |
| `language`   | Код мови для результатів, як-от `en`, `de` або `fr`                |

## Примітки

- **JSON API** -- використовує нативну кінцеву точку SearXNG `format=json`, а не HTML-скрейпінг
- **URL результатів із зображеннями** -- результати категорії зображень містять `img_src`, коли SearXNG
  повертає прямий URL зображення
- **Без API-ключа** -- працює з будь-яким екземпляром SearXNG одразу
- **Перевірка базового URL** -- `baseUrl` має бути дійсним URL `http://` або `https://`;
  публічні хости мають використовувати `https://`
- **Мережевий захист** -- приватні/внутрішні кінцеві точки SearXNG явно вмикають
  доступ до приватної мережі; публічні кінцеві точки SearXNG `https://` зберігають суворий
  захист від SSRF
- **Порядок автовиявлення** -- SearXNG перевіряється останнім (порядок 200) під час
  автовиявлення. API-backed провайдери з налаштованими ключами запускаються першими, потім
  DuckDuckGo (порядок 100), потім Ollama Web Search (порядок 110)
- **Самостійне розгортання** -- ви контролюєте екземпляр, запити та upstream пошукові рушії
- **Категорії** за замовчуванням мають значення `general`, якщо не налаштовані
- **Резервна категорія** -- якщо запит категорії, відмінної від `general`, успішний, але
  повертає нуль результатів, OpenClaw повторює той самий запит один раз із `general`
  перед поверненням порожнього набору результатів

<Tip>
  Щоб JSON API SearXNG працював, переконайтеся, що у вашому екземплярі SearXNG увімкнено формат `json`
  у його `settings.yml` у розділі `search.formats`.
</Tip>

## Пов'язане

- [Огляд Web Search](/uk/tools/web) -- усі провайдери й автовиявлення
- [Пошук DuckDuckGo](/uk/tools/duckduckgo-search) -- ще один резервний варіант без ключа
- [Brave Search](/uk/tools/brave-search) -- структуровані результати з безкоштовним рівнем