Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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 la configurazione in produzione.
2

Configura

openclaw configure --section web
# Select "searxng" as the 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", // 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

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 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
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