Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw ondersteunt SearXNG als een zelfgehoste, sleutelvrije web_search-provider. SearXNG is een opensource meta-zoekmachine die resultaten verzamelt van Google, Bing, DuckDuckGo en andere bronnen. Voordelen:
  • Gratis en onbeperkt — geen API-sleutel of commercieel abonnement vereist
  • Privacy / air-gap — zoekopdrachten verlaten je netwerk nooit
  • Werkt overal — geen regiobeperkingen voor commerciële zoek-API’s

​
Instellen

1

Een SearXNG-instantie uitvoeren

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

Configureren

openclaw configure --section web
# Select "searxng" as the provider
Of stel de env var in en laat automatische detectie deze vinden:
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 prive-SearXNG-hosts
  • http:// wordt alleen geaccepteerd voor vertrouwde private-netwerk- of local loopback-hosts
  • openbare SearXNG-hosts moeten https:// gebruiken

​
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

VeldBeschrijving
baseUrlBasis-URL van je SearXNG-instantie (vereist)
categoriesDoor komma’s 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, niet HTML-scraping
  • 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
  • Volgorde voor automatische detectie — SearXNG wordt als laatste gecontroleerd (volgorde 200) in automatische detectie. API-ondersteunde providers met geconfigureerde sleutels worden eerst uitgevoerd, daarna DuckDuckGo (volgorde 100), daarna Ollama Web Search (volgorde 110)
  • Zelfgehost — jij beheert de instantie, zoekopdrachten en upstream-zoekmachines
  • Categorieen zijn standaard general wanneer ze niet zijn geconfigureerd
Om de SearXNG JSON-API te laten werken, zorg je ervoor dat je SearXNG-instantie de json- indeling heeft ingeschakeld in de settings.yml onder search.formats.

​
Gerelateerd