Поиск SearXNG

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

​

Настройка

openclaw plugins install @openclaw/searxng-plugin

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web
# Выберите "searxng" в качестве провайдера

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

​

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

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

{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // необязательно
            language: "en", // необязательно
          },
        },
      },
    },
  },
}

​

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

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

​

Справочник по конфигурации плагина

​

Примечания

• JSON API — используется нативная конечная точка SearXNG format=json, а не извлечение данных из HTML
• URL результатов поиска изображений — результаты категории изображений содержат img_src, если SearXNG возвращает прямой URL изображения
• Без ключа API — работает с любым экземпляром SearXNG без дополнительной настройки
• Проверка базового URL — baseUrl должен быть допустимым URL http:// или https://
• Защита сети — базовые URL http:// должны указывать на доверенный частный или loopback-хост (для публичных хостов необходимо использовать https://); к базовым URL https://, которые разрешаются в частный/внутренний адрес, применяется то же разрешение для самостоятельно размещаемых экземпляров, а для базовых URL https://, которые разрешаются в публичный адрес, сохраняется строгая защита от SSRF
• Порядок автоматического обнаружения — для SearXNG требуется настроенный baseUrl (порядковый номер 200 среди провайдеров, у которых уже есть необходимые учетные данные). Провайдеры без ключа, такие как DuckDuckGo или Ollama Web Search, никогда не выбираются автоматически неявным образом; они активируются только при явном выборе provider
• Самостоятельное размещение — вы контролируете экземпляр, запросы и вышестоящие поисковые системы
• Категории по умолчанию имеют значение general, если они не настроены
• Резервная категория — если запрос категории, отличной от general, завершается успешно, но возвращает ноль результатов, OpenClaw один раз повторяет тот же запрос с general, прежде чем вернуть пустой набор результатов
• Кэширование результатов — идентичные запросы (с одинаковыми запросом, количеством, категориями, языком и базовым URL) кэшируются внутри процесса на короткое время жизни
• Требование к версии — плагин объявляет minHostVersion: >=2026.6.9

​

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

• Обзор веб-поиска — все провайдеры и автоматическое обнаружение
• Поиск DuckDuckGo — еще один провайдер без ключа
• Поиск Brave — структурированные результаты с бесплатным тарифом