---
read_when:
    - Вам нужен самостоятельно размещаемый поставщик веб-поиска
    - Вы хотите использовать SearXNG для web_search
    - Вам нужен вариант поиска с акцентом на конфиденциальность или для изолированной среды
summary: Веб-поиск SearXNG -- самостоятельно размещаемый поставщик метапоиска без ключей
title: Поиск SearXNG
x-i18n:
    generated_at: "2026-06-28T23:54:48Z"
    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/) для настройки в production.

  </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://`
  остаются на строгой защите web-search и не могут перенаправлять на частные
  адреса

## Переменная окружения

Задайте `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>

## Связанные материалы

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