Перейти до основного вмісту

​
Пошук SearXNG

OpenClaw підтримує SearXNG як self-hosted, key-free провайдера web_search. SearXNG — це open-source метапошуковий рушій, який агрегує результати з Google, Bing, DuckDuckGo та інших джерел. Переваги:
  • Безкоштовно й без обмежень — не потрібні API-ключ чи комерційна підписка
  • Приватність / air-gap — запити ніколи не залишають вашу мережу
  • Працює будь-де — немає регіональних обмежень комерційних API пошуку

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

1

Запустіть екземпляр SearXNG

docker run -d -p 8888:8080 searxng/searxng
Або використайте будь-яке наявне розгортання SearXNG, до якого у вас є доступ. Див. документацію SearXNG щодо розгортання у production.
2

Налаштуйте

openclaw configure --section web
# Select "searxng" as the provider
Або встановіть env var і дозвольте автовизначенню знайти його:
export SEARXNG_BASE_URL="http://localhost:8888"

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

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
Налаштування на рівні plugin-а для екземпляра SearXNG: 
{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}
Поле baseUrl також приймає об’єкти SecretRef. Правила транспорту:
  • https:// працює для публічних або приватних хостів SearXNG
  • http:// приймається лише для довірених хостів у приватній мережі або loopback
  • публічні хости SearXNG мають використовувати https://

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

Установіть SEARXNG_BASE_URL як альтернативу конфігурації: 
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 — використовує нативний endpoint SearXNG format=json, а не HTML scraping
  • Без API-ключа — працює з будь-яким екземпляром SearXNG одразу
  • Валідація базового URL — baseUrl має бути коректним URL http:// або https://; публічні хости мають використовувати https://
  • Порядок автовизначення — SearXNG перевіряється останнім (order 200) в автовизначенні. Спочатку запускаються провайдери на основі API з налаштованими ключами, потім DuckDuckGo (order 100), потім Ollama Web Search (order 110)
  • Self-hosted — ви керуєте екземпляром, запитами й upstream-пошуковими рушіями
  • Categories типово дорівнює general, якщо не налаштовано
Щоб JSON API SearXNG працював, переконайтеся, що у вашому екземплярі SearXNG увімкнено формат json у settings.yml в розділі search.formats.

​
Пов’язане