Wyszukiwanie SearXNG

OpenClaw obsługuje SearXNG jako samodzielnie hostowanego, niewymagającego klucza dostawcę web_search. SearXNG to metawyszukiwarka o otwartym kodzie źródłowym, która agreguje wyniki z Google, Bing, DuckDuckGo i innych źródeł.

Zalety:

• Bezpłatne i bez limitów -- nie wymaga klucza API ani komercyjnej subskrypcji
• Prywatność / izolacja sieciowa -- zapytania nigdy nie opuszczają Twojej sieci
• Działa wszędzie -- brak ograniczeń regionalnych komercyjnych interfejsów API wyszukiwania

Konfiguracja

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Wybierz "searxng" jako dostawcę

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

Konfiguracja

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

Ustawienia instancji SearXNG na poziomie Pluginu:

{  plugins: {    entries: {      searxng: {        config: {          webSearch: {            baseUrl: "http://localhost:8888",            categories: "general,news", // opcjonalne            language: "en", // opcjonalne          },        },      },    },  },}

baseUrl akceptuje również obiekt SecretRef (na przykład { source: "env", id: "SEARXNG_BASE_URL" }).

Zmienna środowiskowa

Jako alternatywę dla konfiguracji ustaw SEARXNG_BASE_URL:

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

Kolejność rozpoznawania: skonfigurowany ciąg baseUrl, następnie wbudowany SecretRef zmiennej środowiskowej w baseUrl, a następnie SEARXNG_BASE_URL. Gdy żadna ze ścieżek konfiguracji nie jest ustawiona, zmienna SEARXNG_BASE_URL jest dostępna i nie wybrano jawnie dostawcy, mechanizm automatycznego wykrywania wybiera SearXNG.

Dokumentacja konfiguracji Pluginu

Wywołanie narzędzia web_search akceptuje również parametry count (1–10 wyników), categories i language jako ustawienia zastępujące dla poszczególnych wywołań.

Uwagi

• API JSON -- korzysta z natywnego punktu końcowego format=json SearXNG, a nie z pozyskiwania danych z HTML
• Adresy URL wyników graficznych -- wyniki z kategorii obrazów zawierają img_src, gdy SearXNG zwraca bezpośredni adres URL obrazu
• Bez klucza API -- działa od razu z dowolną instancją SearXNG
• Walidacja bazowego adresu URL -- baseUrl musi być prawidłowym adresem URL http:// lub https://
• Ochrona sieciowa -- bazowe adresy URL http:// muszą wskazywać zaufany prywatny host lub local loopback (hosty publiczne muszą używać https://); bazowe adresy URL https://, które są rozpoznawane jako adres prywatny lub wewnętrzny, otrzymują takie samo zezwolenie dla samodzielnego hostowania, natomiast bazowe adresy URL https://, które są rozpoznawane jako publiczne, zachowują ścisłą ochronę przed SSRF
• Kolejność automatycznego wykrywania -- SearXNG wymaga skonfigurowanego baseUrl (pozycja 200 wśród dostawców, którzy mają już wymagane dane uwierzytelniające). Dostawcy niewymagający klucza, tacy jak DuckDuckGo lub Ollama Web Search, nigdy nie są wybierani niejawnie przez automatyczne wykrywanie; aktywują się tylko po jawnym wyborze provider
• Samodzielne hostowanie -- kontrolujesz instancję, zapytania i nadrzędne wyszukiwarki
• Kategorie domyślnie przyjmują wartość general, jeśli nie zostały skonfigurowane
• Mechanizm zastępczy kategorii -- jeśli żądanie kategorii innej niż general zakończy się powodzeniem, ale zwróci zero wyników, OpenClaw ponowi to samo zapytanie jeden raz z kategorią general, zanim zwróci pusty zestaw wyników
• Buforowanie wyników -- identyczne zapytania (to samo zapytanie, liczba wyników, kategorie, język i bazowy adres URL) są przez krótki czas TTL przechowywane w pamięci podręcznej procesu
• Wymagana wersja -- Plugin deklaruje minHostVersion: >=2026.6.9

Powiązane

• Omówienie wyszukiwania internetowego -- wszyscy dostawcy i automatyczne wykrywanie
• Wyszukiwanie DuckDuckGo -- kolejny dostawca niewymagający klucza
• Wyszukiwanie Brave -- ustrukturyzowane wyniki z bezpłatnym pakietem