Ricerca SearXNG

OpenClaw supporta SearXNG come provider web_search self-hosted, senza chiavi. SearXNG è un metamotore di ricerca open source che aggrega risultati da Google, Bing, DuckDuckGo e altre fonti.

Vantaggi:

• Gratuito e illimitato -- non richiede chiavi API né abbonamenti commerciali
• Privacy / isolamento dalla rete -- le query non lasciano mai la tua rete
• Funziona ovunque -- nessuna restrizione geografica delle API di ricerca commerciali

Configurazione

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Seleziona "searxng" come provider

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

Configurazione

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

Impostazioni a livello di plugin per l'istanza SearXNG:

{  plugins: {    entries: {      searxng: {        config: {          webSearch: {            baseUrl: "http://localhost:8888",            categories: "general,news", // facoltativo            language: "en", // facoltativo          },        },      },    },  },}

baseUrl accetta anche un oggetto SecretRef (ad esempio { source: "env", id: "SEARXNG_BASE_URL" }).

Variabile d'ambiente

Imposta SEARXNG_BASE_URL in alternativa alla configurazione:

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

Ordine di risoluzione: stringa baseUrl configurata, quindi un SecretRef di ambiente inline in baseUrl, infine SEARXNG_BASE_URL. Quando nessuno dei percorsi di configurazione è impostato e SEARXNG_BASE_URL è presente senza un provider scelto esplicitamente, il rilevamento automatico seleziona SearXNG.

Riferimento per la configurazione del plugin

La chiamata allo strumento web_search accetta anche count (1-10 risultati), categories e language come sostituzioni specifiche per ciascuna chiamata.

Note

• API JSON -- usa l'endpoint nativo format=json di SearXNG, non l'estrazione dall'HTML
• URL dei risultati delle immagini -- i risultati della categoria immagini includono img_src quando SearXNG restituisce un URL diretto dell'immagine
• Nessuna chiave API -- funziona immediatamente con qualsiasi istanza SearXNG
• Convalida dell'URL di base -- baseUrl deve essere un URL http:// o https:// valido
• Protezione di rete -- gli URL di base http:// devono puntare a un host privato attendibile o local loopback (gli host pubblici devono usare https://); gli URL di base https:// che vengono risolti in un indirizzo privato/interno ricevono la stessa autorizzazione self-hosted, mentre gli URL di base https:// risolti pubblicamente mantengono una rigorosa protezione SSRF
• Ordine di rilevamento automatico -- SearXNG richiede un baseUrl configurato (ordine 200 tra i provider che dispongono già delle credenziali richieste). I provider senza chiavi, come DuckDuckGo o Ollama Web Search, non prevalgono mai implicitamente nel rilevamento automatico; si attivano solo tramite una scelta esplicita di provider
• Self-hosted -- controlli l'istanza, le query e i motori di ricerca upstream
• Categorie -- il valore predefinito è general quando non sono configurate
• Ripiego della categoria -- se una richiesta per una categoria diversa da general riesce ma restituisce zero risultati, OpenClaw ripete una volta la stessa query con general prima di restituire un insieme di risultati vuoto
• Memorizzazione nella cache dei risultati -- le query identiche (stessa query, conteggio, categorie, lingua e URL di base) vengono memorizzate nella cache del processo per un breve TTL
• Requisito di versione -- il plugin dichiara minHostVersion: >=2026.6.9

Contenuti correlati

• Panoramica della ricerca web -- tutti i provider e il rilevamento automatico
• Ricerca DuckDuckGo -- un altro provider senza chiavi
• Ricerca Brave -- risultati strutturati con piano gratuito