---
read_when:
    - Вам потрібен самостійно розміщений постачальник вебпошуку
    - Ви хочете використовувати SearXNG для web_search
    - Вам потрібен варіант пошуку з акцентом на приватність або для ізольованого середовища
summary: Вебпошук SearXNG -- самостійно розгорнутий постачальник метапошуку без ключів
title: Пошук SearXNG
x-i18n:
    generated_at: "2026-06-27T18:28:25Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 4bd00a20e45f71b7bd855a6588d5c829a0202839fc93ddcec1e255b7858ff183
    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="Установіть Plugin">
    ```bash
    openclaw plugins install @openclaw/searxng-plugin
    ```
  </Step>
  <Step title="Запустіть інстанс SearXNG">
    ```bash
    docker run -d -p 8888:8080 searxng/searxng
    ```

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

  </Step>
  <Step title="Налаштуйте">
    ```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 з
ключем має перевагу).

## Довідник конфігурації 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 перевіряється після провайдерів на основі API
  з налаштованими ключами (порядок 200). Безключові провайдери, як-от DuckDuckGo або
  Ollama Web Search, не вибираються автоматично без явного вибору провайдера
- **Самостійно розгорнуто** -- ви контролюєте інстанс, запити та висхідні пошукові рушії
- **Категорії** за замовчуванням мають значення `general`, якщо їх не налаштовано
- **Резервна категорія** -- якщо запит до категорії, відмінної від `general`, успішний, але
  повертає нуль результатів, OpenClaw повторює той самий запит один раз із `general`
  перед поверненням порожнього набору результатів

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

## Пов’язане

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