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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

1

Run a SearXNG instance

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

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 перед поверненням порожнього набору результатів
Щоб JSON API SearXNG працював, переконайтеся, що у вашому екземплярі SearXNG увімкнено формат json у його settings.yml у розділі search.formats.

​
Пов’язане

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