Ricerca SearXNG

• 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",
      },
    },
  },
}

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

​

Variabile d’ambiente

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

​

Riferimento per la configurazione del plugin

​

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