SearXNG-zoekopdracht

OpenClaw ondersteunt SearXNG als zelf-gehoste, sleutelvrije web_search-provider. SearXNG is een open-source meta-zoekmachine die resultaten van Google, Bing, DuckDuckGo en andere bronnen samenvoegt.

Voordelen:

• Gratis en onbeperkt -- geen API-sleutel of commercieel abonnement vereist
• Privacy / air-gap -- zoekopdrachten verlaten je netwerk nooit
• Werkt overal -- geen regiobeperkingen op commerciële zoek-API's

# Installatie

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

openclaw configure --section web
# Select "searxng" as the provider

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

# Configuratie

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

Instellingen op Plugin-niveau voor de SearXNG-instantie:

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

Het veld baseUrl accepteert ook SecretRef-objecten.

Transportregels:

• https:// werkt voor openbare of private SearXNG-hosts
• http:// wordt alleen geaccepteerd voor vertrouwde private-network- of loopback-hosts
• openbare SearXNG-hosts moeten https:// gebruiken
• private/interne hosts gebruiken de zelf-gehoste netwerkbeveiliging; openbare https://- hosts blijven op de strikte webzoekbeveiliging en kunnen niet doorverwijzen naar private adressen

# Omgevingsvariabele

Stel SEARXNG_BASE_URL in als alternatief voor configuratie:

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

Wanneer SEARXNG_BASE_URL is ingesteld en er geen expliciete provider is geconfigureerd, kiest automatische detectie SearXNG automatisch (met de laagste prioriteit -- elke API-ondersteunde provider met een sleutel wint eerst).

# Referentie voor Plugin-configuratie

# Opmerkingen

• JSON-API -- gebruikt het native format=json-endpoint van SearXNG, geen HTML-scraping
• URL's van afbeeldingsresultaten -- resultaten uit afbeeldingscategorieen bevatten img_src wanneer SearXNG een directe afbeeldings-URL retourneert
• Geen API-sleutel -- werkt direct met elke SearXNG-instantie
• Validatie van basis-URL -- baseUrl moet een geldige http://- of https://- URL zijn; openbare hosts moeten https:// gebruiken
• Netwerkbeveiliging -- private/interne SearXNG-endpoints kiezen expliciet voor toegang tot private netwerken; openbare https:// SearXNG-endpoints behouden strikte SSRF- bescherming
• Volgorde van automatische detectie -- SearXNG wordt als laatste gecontroleerd (volgorde 200) in automatische detectie. API-ondersteunde providers met geconfigureerde sleutels draaien eerst, daarna DuckDuckGo (volgorde 100), daarna Ollama Web Search (volgorde 110)
• Zelf-gehost -- jij beheert de instantie, zoekopdrachten en upstream-zoekmachines
• Categorieen gebruiken standaard general wanneer ze niet zijn geconfigureerd
• Categoriefallback -- als een categorieaanvraag anders dan general slaagt maar nul resultaten retourneert, probeert OpenClaw dezelfde zoekopdracht nog eenmaal met general voordat een lege resultatenset wordt geretourneerd

# Gerelateerd

• Overzicht van Web Search -- alle providers en automatische detectie
• DuckDuckGo Search -- nog een sleutelvrije fallback
• Brave Search -- gestructureerde resultaten met gratis laag