English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

Пошук SearXNG

OpenClaw підтримує SearXNG як самостійно розгорнутий, без ключа провайдер web_search. SearXNG — це метапошуковий рушій із відкритим кодом, який агрегує результати з Google, Bing, DuckDuckGo та інших джерел.

Переваги:

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

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

  • Run a SearXNG instance

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

    Або використайте будь-яке наявне розгортання SearXNG, до якого маєте доступ. Див. документацію SearXNG для налаштування у продакшені.

  • Configure

    openclaw configure --section web
# Select "searxng" as the provider

    Або задайте змінну середовища й дозвольте автовиявленню знайти її:

    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://
    • приватні/внутрішні хости використовують мережевий захист для самостійно розгорнутих середовищ; публічні хости https:// залишаються під суворим захистом вебпошуку й не можуть переспрямовувати на приватні адреси

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

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

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

    Коли SEARXNG_BASE_URL задано й явний провайдер не налаштовано, автовиявлення автоматично вибирає SearXNG (з найнижчим пріоритетом -- будь-який API-backed провайдер із ключем перемагає першим).

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

    Пов'язане

    • Огляд Web Search -- усі провайдери й автовиявлення
    • Пошук DuckDuckGo -- ще один резервний варіант без ключа
    • Brave Search -- структуровані результати з безкоштовним рівнем