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łatne i bez limitów -- nie wymaga klucza API ani subskrypcji komercyjnej
• Prywatność / izolacja sieciowa -- zapytania nigdy nie opuszczają Twojej sieci
• Działa wszędzie -- bez ograniczeń regionalnych komercyjnych API wyszukiwania

# Konfiguracja

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 także 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 pętli zwrotnej
• publiczne hosty SearXNG muszą używać https://
• hosty prywatne/wewnętrzne używają zabezpieczenia sieci samodzielnie hostowanej; publiczne hosty https:// pozostają przy ścisłym zabezpieczeniu 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 wybiera SearXNG automatycznie (z najniższym priorytetem -- każdy dostawca oparty na API z kluczem wygrywa jako pierwszy).

# Dokumentacja konfiguracji Plugin

# Uwagi

• JSON API -- używa natywnego punktu końcowego SearXNG format=json, a nie scrapowania HTML
• Adresy URL wyników obrazów -- wyniki kategorii obrazów zawierają img_src, gdy SearXNG zwraca bezpośredni 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://; publiczne hosty muszą używać https://
• Zabezpieczenie sieci -- prywatne/wewnętrzne punkty końcowe SearXNG włączają dostęp do sieci prywatnej; publiczne punkty końcowe SearXNG https:// zachowują ścisłą ochronę przed SSRF
• Kolejność automatycznego wykrywania -- SearXNG jest sprawdzany jako ostatni (kolejność 200) w automatycznym wykrywaniu. Dostawcy oparci na API ze skonfigurowanymi kluczami uruchamiają się jako pierwsi, następnie DuckDuckGo (kolejność 100), a potem Ollama Web Search (kolejność 110)
• Samodzielnie hostowane -- kontrolujesz instancję, zapytania i nadrzędne wyszukiwarki
• Kategorie domyślnie przyjmują general, gdy nie są skonfigurowane
• Rezerwowa 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
• Wyszukiwanie DuckDuckGo -- kolejna rezerwowa opcja bez klucza
• Brave Search -- ustrukturyzowane wyniki z bezpłatnym poziomem