OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

SearXNG-zoeken

OpenClaw ondersteunt SearXNG als een zelfgehoste, sleutelvrije web_search-provider. 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 uw netwerk nooit
  • Werkt overal -- geen regiobeperkingen van commerciële zoek-API's

Installatie

  • Installeer de Plugin

    bash
    openclaw plugins install @openclaw/searxng-plugin

  • Voer een SearXNG-instantie uit

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

    U kunt ook een bestaande SearXNG-implementatie gebruiken waartoe u toegang hebt. Raadpleeg de SearXNG-documentatie voor installatie in een productieomgeving.

  • Configureren

    bash
    openclaw configure --section web# Selecteer "searxng" als provider

    U kunt ook de omgevingsvariabele instellen en deze automatisch laten detecteren:

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

    • Configuratie

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

    Instellingen op Plugin-niveau voor de SearXNG-instantie:

    json5
    {  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:

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

    Volgorde van resolutie: de geconfigureerde baseUrl-tekenreeks, vervolgens een inline SecretRef voor een omgevingsvariabele in baseUrl en daarna SEARXNG_BASE_URL. Wanneer geen van de configuratiepaden is ingesteld en SEARXNG_BASE_URL aanwezig is zonder dat expliciet een provider is gekozen, selecteert de automatische detectie SearXNG.

    Naslag voor Plugin-configuratie

    Veld Beschrijving
    baseUrl Basis-URL van uw SearXNG-instantie (vereist)
    categories Kommaggescheiden categorieën zoals general, news of science
    language Taalcode voor resultaten, zoals en, de of fr

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

    Opmerkingen

    • JSON-API -- gebruikt het systeemeigen format=json-eindpunt van SearXNG, niet het scrapen van HTML
    • URL's van afbeeldingsresultaten -- resultaten in de afbeeldingscategorie bevatten img_src wanneer SearXNG een directe afbeeldings-URL retourneert
    • Geen API-sleutel -- werkt direct met elke SearXNG-instantie
    • Validatie van de basis-URL -- baseUrl moet een geldige http://- of https://- URL zijn
    • Netwerkbeveiliging -- http://-basis-URL's moeten verwijzen naar een vertrouwde privéhost of local loopback-host (openbare hosts moeten https:// gebruiken); https://-basis-URL's die naar een privé- of intern adres worden omgezet, krijgen dezelfde toestemming voor zelfhosting, terwijl voor https://-basis-URL's die naar een openbaar adres worden omgezet strikte SSRF-bescherming blijft gelden
    • Volgorde van automatische detectie -- SearXNG vereist een geconfigureerde baseUrl (volgorde 200 onder providers die al over de vereiste referentiegegevens beschikken). Sleutelvrije providers zoals DuckDuckGo of Ollama Web Search worden nooit impliciet via automatische detectie gekozen; ze worden alleen geactiveerd door een expliciete keuze voor provider
    • Zelfgehost -- u beheert de instantie, zoekopdrachten en bovenliggende zoekmachines
    • Categorieën zijn standaard ingesteld op general wanneer ze niet zijn geconfigureerd
    • Terugval voor categorieën -- als een aanvraag voor een andere categorie dan general slaagt maar geen resultaten oplevert, probeert OpenClaw dezelfde zoekopdracht eenmaal opnieuw met general voordat een lege resultatenset wordt geretourneerd
    • Resultaatcaching -- identieke zoekopdrachten (dezelfde zoekopdracht, hetzelfde aantal, dezelfde categorieën, dezelfde taal en dezelfde basis-URL) worden gedurende een korte TTL in het proces gecachet
    • Versievereiste -- de Plugin declareert minHostVersion: >=2026.6.9

    Gerelateerd

    Was this useful?
    On this page

    On this page