Vai al contenuto principale

Ricerca DuckDuckGo

OpenClaw supporta DuckDuckGo come provider web_search senza chiave. Non è richiesta alcuna chiave API né alcun account.
DuckDuckGo è un’integrazione sperimentale e non ufficiale che estrae i risultati dalle pagine di ricerca non JavaScript di DuckDuckGo, non da un’API ufficiale. Aspettati occasionali rotture dovute a pagine di bot challenge o cambiamenti dell’HTML.

Configurazione

Non serve alcuna chiave API: basta impostare DuckDuckGo come provider:
1

Configura

openclaw configure --section web
# Seleziona "duckduckgo" come provider

Configurazione

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
Impostazioni facoltative a livello di plugin per regione e SafeSearch:
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // Codice regione DuckDuckGo
            safeSearch: "moderate", // "strict", "moderate" oppure "off"
          },
        },
      },
    },
  },
}

Parametri dello strumento

ParametroDescrizione
queryQuery di ricerca (obbligatoria)
countRisultati da restituire (1-10, predefinito: 5)
regionCodice regione DuckDuckGo (ad es. us-en, uk-en, de-de)
safeSearchLivello SafeSearch: strict, moderate (predefinito) o off
Regione e SafeSearch possono anche essere impostati nella configurazione del plugin (vedi sopra): i parametri dello strumento sovrascrivono i valori di configurazione per ogni query.

Note

  • Nessuna chiave API — funziona subito, senza configurazione
  • Sperimentale — raccoglie i risultati dalle pagine di ricerca HTML non JavaScript di DuckDuckGo, non da un’API o SDK ufficiale
  • Rischio di bot challenge — DuckDuckGo può mostrare CAPTCHA o bloccare le richieste in caso di uso intenso o automatizzato
  • Parsing HTML — i risultati dipendono dalla struttura della pagina, che può cambiare senza preavviso
  • Ordine di rilevamento automatico — DuckDuckGo è il primo fallback senza chiave (ordine 100) nel rilevamento automatico. I provider supportati da API con chiavi configurate vengono eseguiti per primi, poi Ollama Web Search (ordine 110), poi SearXNG (ordine 200)
  • SafeSearch è predefinito su moderate quando non configurato
Per l’uso in produzione, prendi in considerazione Brave Search (livello gratuito disponibile) o un altro provider supportato da API.

Correlati