Wyszukiwanie SearXNG

OpenClaw obsługuje SearXNG jako samodzielnie hostowanego, bezkluczowego dostawcę web_search. SearXNG to otwartoźródłowa metawyszukiwarka, która agreguje wyniki z Google, Bing, DuckDuckGo i innych źródeł.

Zalety:

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

Konfiguracja

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"

Konfiguracja

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

Ustawienia na poziomie Plugin dla instancji SearXNG:

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

Pole baseUrl akceptuje również obiekty SecretRef.

Reguły transportu:

• https:// działa dla publicznych lub prywatnych hostów SearXNG
• http:// jest akceptowane tylko dla zaufanych hostów w sieci prywatnej lub hostów loopback
• publiczne hosty SearXNG muszą używać https://
• hosty prywatne/wewnętrzne używają strażnika sieci samodzielnie hostowanej; publiczne hosty https:// pozostają objęte ścisłym strażnikiem wyszukiwania w sieci i nie mogą przekierowywać na adresy prywatne

Zmienna środowiskowa

Ustaw SEARXNG_BASE_URL jako alternatywę dla konfiguracji:

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

Gdy SEARXNG_BASE_URL jest ustawiona i nie skonfigurowano jawnego dostawcy, automatyczne wykrywanie automatycznie wybiera SearXNG (z najniższym priorytetem -- każdy dostawca oparty na API z kluczem wygrywa jako pierwszy).

Dokumentacja konfiguracji Plugin

Uwagi

• API JSON -- używa natywnego punktu końcowego SearXNG format=json, a nie scrapowania HTML
• Adresy URL wyników obrazów -- wyniki z kategorii obrazów zawierają img_src, gdy SearXNG zwraca bezpośredni adres URL obrazu
• Brak klucza API -- działa od razu z dowolną instancją SearXNG
• Walidacja bazowego URL -- baseUrl musi być prawidłowym adresem URL http:// lub https://; hosty publiczne muszą używać https://
• Strażnik sieci -- prywatne/wewnętrzne punkty końcowe SearXNG jawnie włączają dostęp do sieci prywatnej; publiczne punkty końcowe SearXNG https:// zachowują ścisłą ochronę SSRF
• Kolejność automatycznego wykrywania -- SearXNG jest sprawdzany po dostawcach opartych na API ze skonfigurowanymi kluczami (kolejność 200). Dostawcy bez klucza, tacy jak DuckDuckGo lub Ollama Web Search, nie są automatycznie wybierani bez jawnego wyboru dostawcy
• Samodzielnie hostowane -- kontrolujesz instancję, zapytania i nadrzędne wyszukiwarki
• Kategorie domyślnie mają wartość general, gdy nie są skonfigurowane
• Awaryjna kategoria -- jeśli żądanie kategorii innej niż general powiedzie się, ale zwróci zero wyników, OpenClaw ponawia to samo zapytanie raz z general przed zwróceniem pustego zestawu wyników

Powiązane

• Omówienie wyszukiwania w sieci -- wszyscy dostawcy i automatyczne wykrywanie
• DuckDuckGo Search -- kolejny dostawca bez klucza
• Brave Search -- uporządkowane wyniki z bezpłatnym poziomem