Skip to main content
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

1

Installeer de Plugin

2

Voer een SearXNG-instantie uit

Je kunt ook een bestaande SearXNG-implementatie gebruiken waartoe je toegang hebt. Raadpleeg de SearXNG-documentatie voor de productieconfiguratie.
3

Configureer

Je kunt ook de omgevingsvariabele instellen en deze via automatische detectie laten vinden:

​
Configuratie

Instellingen op Plugin-niveau voor de SearXNG-instantie:
baseUrl accepteert ook een SecretRef-object (bijvoorbeeld { source: "env", id: "SEARXNG_BASE_URL" }).

​
Omgevingsvariabele

Stel SEARXNG_BASE_URL in als alternatief voor de configuratie:
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
Zorg ervoor dat de json-indeling in settings.yml onder search.formats is ingeschakeld in je SearXNG-instantie, zodat de JSON-API van SearXNG werkt.

​
Gerelateerd