Пошук SearXNG

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

Переваги:

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

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

openclaw plugins install @openclaw/searxng-plugin

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

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 з ключем має перевагу).

Довідник конфігурації Plugin

Примітки

• 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 перед поверненням порожнього набору результатів

Пов’язане

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