Naar hoofdinhoud gaan
OpenClaw ondersteunt SearXNG als een zelf gehoste, sleutelvrije web_search-aanbieder. SearXNG is een open-source metazoekmachine die resultaten uit Google, Bing, DuckDuckGo en andere bronnen samenvoegt. Voordelen:
  • Gratis en onbeperkt — geen API-sleutel of commercieel abonnement vereist
  • Privacy / air-gap — zoekopdrachten verlaten nooit je netwerk
  • Werkt overal — geen regiobeperkingen op commerciële zoek-API’s

​
Installatie

1

Installeer de Plugin

openclaw plugins install @openclaw/searxng-plugin
2

Voer een SearXNG-instantie uit

docker run -d -p 8888:8080 searxng/searxng
Of gebruik een bestaande SearXNG-implementatie waartoe je toegang hebt. Zie de SearXNG-documentatie voor productie-installatie.
3

Configureer

openclaw configure --section web
# Select "searxng" as the provider
Of stel de omgevingsvariabele in en laat automatische detectie deze vinden:
export SEARXNG_BASE_URL="http://localhost:8888"

​
Configuratie

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
Plugin-niveau-instellingen 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-netwerk- of loopback-hosts
  • openbare SearXNG-hosts moeten https:// gebruiken
  • private/interne hosts gebruiken de zelf gehoste netwerkbeveiliging; openbare https://-hosts blijven onder 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 aanbieder is geconfigureerd, kiest automatische detectie SearXNG automatisch (met de laagste prioriteit — elke door een API ondersteunde aanbieder met een sleutel wint eerst).

​
Referentie voor Plugin-configuratie

VeldBeschrijving
baseUrlBasis-URL van je SearXNG-instantie (vereist)
categoriesKomma-gescheiden categorieen zoals general, news of science
languageTaalcode voor resultaten zoals en, de of fr

​
Opmerkingen

  • JSON-API — gebruikt SearXNG’s native format=json-endpoint, geen HTML-scraping
  • URL’s van afbeeldingsresultaten — resultaten in 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 voor private-netwerktoegang; openbare https:// SearXNG-endpoints behouden strikte SSRF- bescherming
  • Volgorde van automatische detectie — SearXNG wordt gecontroleerd na door API ondersteunde aanbieders met geconfigureerde sleutels (volgorde 200). Sleutelvrije aanbieders zoals DuckDuckGo of Ollama Web Search worden niet automatisch geselecteerd zonder expliciete aanbiederskeuze
  • Zelf gehost — jij beheert de instantie, zoekopdrachten en upstream zoekmachines
  • Categorieen staan standaard op general wanneer ze niet zijn geconfigureerd
  • Categoriefallback — als een categorieaanvraag anders dan general slaagt maar nul resultaten retourneert, probeert OpenClaw dezelfde zoekopdracht nog een keer met general voordat een lege resultatenset wordt geretourneerd
Zorg ervoor dat je SearXNG-instantie de json-indeling heeft ingeschakeld in settings.yml onder search.formats, zodat de SearXNG JSON-API werkt.

​
Gerelateerd