SearXNG-zoekopdracht

OpenClaw ondersteunt SearXNG als een zelfgehoste provider zonder sleutel voor web_search. SearXNG is een opensource-metazoekmachine die resultaten van Google, Bing, DuckDuckGo en andere bronnen samenvoegt.

Voordelen:

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

Installatie

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Selecteer "searxng" als 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", // optioneel            language: "en", // optioneel          },        },      },    },  },}

baseUrl accepteert ook een SecretRef-object (bijvoorbeeld { source: "env", id: "SEARXNG_BASE_URL" }).

Omgevingsvariabele

Stel SEARXNG_BASE_URL in als alternatief voor de configuratie:

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

Volgorde van verwerking: de geconfigureerde tekenreeks baseUrl, vervolgens een inline SecretRef voor een omgevingsvariabele op baseUrl en daarna SEARXNG_BASE_URL. Wanneer geen van de configuratiepaden is ingesteld, SEARXNG_BASE_URL aanwezig is en er geen expliciete provider is gekozen, selecteert automatische detectie SearXNG.

Referentie voor Plugin-configuratie

De toolaanroep web_search accepteert ook count (1-10 resultaten), categories en language als overschrijvingen per aanroep.

Opmerkingen

• JSON-API -- gebruikt het native format=json-eindpunt van SearXNG, niet het scrapen van HTML
• URL's van afbeeldingsresultaten -- resultaten uit de afbeeldingscategorie bevatten img_src wanneer SearXNG een rechtstreekse 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
• Netwerkbeveiliging -- http://-basis-URL's moeten naar een vertrouwde privé- of loopbackhost verwijzen (openbare hosts moeten https:// gebruiken); https://-basis-URL's die naar een privé-/intern adres worden omgezet, krijgen dezelfde vrijstelling voor zelfgehoste instanties, terwijl https://-basis-URL's die naar een openbaar adres worden omgezet, strikte SSRF-bescherming behouden
• Volgorde van automatische detectie -- SearXNG vereist een geconfigureerde baseUrl (volgnummer 200 onder providers die al over hun vereiste referentie beschikken). Providers zonder sleutel, zoals DuckDuckGo of Ollama Web Search, worden nooit impliciet door automatische detectie gekozen; ze worden alleen geactiveerd bij een expliciete keuze voor provider
• Zelfgehost -- je beheert de instantie, zoekopdrachten en bovenliggende zoekmachines
• Categorieën gebruiken standaard general wanneer ze niet zijn geconfigureerd
• Terugvalcategorie -- als een categorieaanvraag die niet voor general is, slaagt maar nul resultaten oplevert, probeert OpenClaw dezelfde zoekopdracht één keer opnieuw met general voordat een lege resultatenset wordt geretourneerd
• Resultaatcaching -- identieke zoekopdrachten (dezelfde zoekopdracht, hetzelfde aantal, dezelfde categorieën, taal en basis-URL) worden gedurende een korte TTL binnen het proces gecachet
• Versievereiste -- de Plugin declareert minHostVersion: >=2026.6.9

Gerelateerd

• Overzicht van zoeken op het web -- alle providers en automatische detectie
• Zoeken met DuckDuckGo -- nog een provider zonder sleutel
• Zoeken met Brave -- gestructureerde resultaten met een gratis abonnementscategorie