Ricerca SearXNG

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

Vantaggi:

• Gratuito e illimitato -- non richiede chiave API né abbonamento commerciale
• Privacy / air-gap -- le query non lasciano mai la tua rete
• Funziona ovunque -- nessuna restrizione geografica sulle API di ricerca commerciali

Configurazione

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Select "searxng" as the provider

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

Config

{  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", // optional            language: "en", // optional          },        },      },    },  },}

Il campo baseUrl accetta anche oggetti SecretRef.

Regole di trasporto:

• https:// funziona per host SearXNG pubblici o privati
• http:// è accettato solo per host di rete privata attendibili o local loopback
• gli host SearXNG pubblici devono usare https://
• gli host privati/interni usano la protezione di rete self-hosted; gli host pubblici https:// restano sulla protezione rigorosa per la ricerca web e non possono reindirizzare verso indirizzi privati

Variabile d'ambiente

Imposta SEARXNG_BASE_URL come alternativa alla configurazione:

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

Quando SEARXNG_BASE_URL è impostata e non è configurato alcun provider esplicito, il rilevamento automatico seleziona SearXNG automaticamente (alla priorità più bassa -- qualsiasi provider basato su API con una chiave vince per primo).

Riferimento alla configurazione del Plugin

Note

• API JSON -- usa l'endpoint nativo format=json di SearXNG, non lo scraping HTML
• URL dei risultati immagine -- i risultati della categoria immagini includono img_src quando SearXNG restituisce un URL immagine diretto
• Nessuna chiave API -- funziona con qualsiasi istanza SearXNG senza configurazioni aggiuntive
• Convalida dell'URL di base -- baseUrl deve essere un URL http:// o https:// valido; gli host pubblici devono usare https://
• Protezione di rete -- gli endpoint SearXNG privati/interni optano per l'accesso alla rete privata; gli endpoint SearXNG pubblici https:// mantengono una protezione SSRF rigorosa
• Ordine del rilevamento automatico -- SearXNG viene controllato dopo i provider basati su API con chiavi configurate (ordine 200). I provider senza chiave, come DuckDuckGo o Ollama Web Search, non vengono selezionati automaticamente senza una scelta esplicita del provider
• Self-hosted -- controlli l'istanza, le query e i motori di ricerca upstream
• Categorie usa general come valore predefinito quando non è configurato
• Fallback di categoria -- se una richiesta di categoria non general riesce ma restituisce zero risultati, OpenClaw riprova la stessa query una volta con general prima di restituire un insieme di risultati vuoto

Correlati

• Panoramica di Web Search -- tutti i provider e il rilevamento automatico
• DuckDuckGo Search -- un altro provider senza chiave
• Brave Search -- risultati strutturati con piano gratuito