Vai al contenuto principale

​
Ricerca SearXNG

OpenClaw supporta SearXNG come provider web_search self-hosted e senza chiave. SearXNG è un meta-motore 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 escono mai dalla tua rete
  • Funziona ovunque — nessuna restrizione regionale delle API di ricerca commerciali

​
Configurazione

1

Esegui un'istanza SearXNG

docker run -d -p 8888:8080 searxng/searxng
Oppure usa qualsiasi distribuzione SearXNG esistente a cui hai accesso. Consulta la documentazione di SearXNG per una configurazione di produzione.
2

Configura

openclaw configure --section web
# Seleziona "searxng" come provider
Oppure imposta la variabile d’ambiente e lascia che il rilevamento automatico la trovi:
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
          },
        },
      },
    },
  },
}
Il campo baseUrl accetta anche oggetti SecretRef. Regole di trasporto:
  • https:// funziona per host SearXNG pubblici o privati
  • http:// è accettato solo per host affidabili su rete privata o loopback
  • gli host SearXNG pubblici devono usare https://

​
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 automaticamente SearXNG (alla priorità più bassa — qualsiasi provider supportato da API con una chiave ha priorità).

​
Riferimento della configurazione del plugin

CampoDescrizione
baseUrlURL di base della tua istanza SearXNG (obbligatorio)
categoriesCategorie separate da virgole come general, news o science
languageCodice lingua per i risultati come en, de o fr

​
Note

  • API JSON — usa l’endpoint nativo format=json di SearXNG, non l’estrazione da HTML
  • Nessuna chiave API — funziona subito con qualsiasi istanza SearXNG
  • Validazione dell’URL di base — baseUrl deve essere un URL http:// o https:// valido; gli host pubblici devono usare https://
  • Ordine di rilevamento automatico — SearXNG viene controllato per ultimo (ordine 200) nel rilevamento automatico. I provider supportati da API con chiavi configurate vengono eseguiti per primi, poi DuckDuckGo (ordine 100), poi Ollama Web Search (ordine 110)
  • Self-hosted — controlli l’istanza, le query e i motori di ricerca upstream
  • Categories usa general come valore predefinito quando non è configurato
Per far funzionare l’API JSON di SearXNG, assicurati che la tua istanza SearXNG abbia il formato json abilitato nel suo settings.yml sotto search.formats.

​
Correlati