Ricerca SearXNG

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

Vantaggi:

• Gratuito e illimitato -- non richiede una chiave API o un abbonamento commerciale
• Privacy / isolamento -- le query non lasciano mai la tua rete
• Funziona ovunque -- nessuna restrizione regionale sulle API di ricerca commerciali

# Configurazione

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

openclaw configure --section web
# Select "searxng" as the 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", // 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 loopback
• gli host SearXNG pubblici devono usare https://
• gli host privati/interni usano la protezione di rete autogestita; gli host pubblici https:// restano sulla protezione rigorosa per la ricerca web e non possono reindirizzare a 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 sceglie SearXNG automaticamente (con la 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 subito con qualsiasi istanza SearXNG
• 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 aderiscono all'accesso alla rete privata; gli endpoint SearXNG pubblici https:// mantengono una protezione SSRF rigorosa
• Ordine del rilevamento automatico -- SearXNG viene controllato per ultimo (ordine 200) nel rilevamento automatico. I provider basati su API con chiavi configurate vengono eseguiti per primi, poi DuckDuckGo (ordine 100), poi Ollama Web Search (ordine 110)
• Autogestito -- controlli l'istanza, le query e i motori di ricerca upstream
• Categorie usa general come valore predefinito quando non configurato
• Fallback della categoria -- se una richiesta per una categoria diversa da general riesce ma restituisce zero risultati, OpenClaw riprova la stessa query una volta con general prima di restituire un set di risultati vuoto

# Correlati

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