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

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

Преимущества:

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

## Настройка

<Steps>
  <Step title="Установите Plugin">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/searxng-plugin
    ```
  </Step>

  <Step title="Запустите экземпляр SearXNG">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    docker run -d -p 8888:8080 searxng/searxng
    ```

    Или используйте любую существующую установку SearXNG, к которой у вас есть доступ. См.
    [документацию SearXNG](https://docs.searxng.org/) для настройки в production.
  </Step>

  <Step title="Настройте">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    # Select "searxng" as the provider
    ```

    Или задайте переменную окружения и позвольте автообнаружению найти ее:

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

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

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

Настройки уровня Plugin для экземпляра 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
          },
        },
      },
    },
  },
}
```

Поле `baseUrl` также принимает объекты SecretRef.

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

* `https://` работает для публичных или частных хостов SearXNG
* `http://` принимается только для доверенных хостов в частной сети или loopback
* публичные хосты SearXNG должны использовать `https://`
* частные/внутренние хосты используют сетевую защиту для самостоятельно размещаемых сервисов; публичные хосты `https://`
  остаются на строгой защите web-search и не могут перенаправлять на частные
  адреса

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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) -- структурированные результаты с бесплатным уровнем