Vai al contenuto principale

​
Tavily

OpenClaw può usare Tavily in due modi:
  • come provider web_search
  • come strumenti plugin espliciti: tavily_search e tavily_extract
Tavily è un’API di ricerca progettata per applicazioni IA, che restituisce risultati strutturati ottimizzati per il consumo da parte degli LLM. Supporta profondità di ricerca configurabile, filtraggio per argomento, filtri di dominio, riepiloghi di risposta generati dall’IA ed estrazione di contenuti dagli URL (incluse le pagine renderizzate con JavaScript).

​
Ottieni una chiave API

  1. Crea un account Tavily su tavily.com.
  2. Genera una chiave API nella dashboard.
  3. Memorizzala nella configurazione oppure imposta TAVILY_API_KEY nell’ambiente del gateway.

​
Configura la ricerca Tavily

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
Note:
  • Scegliere Tavily durante l’onboarding o openclaw configure --section web abilita automaticamente il plugin Tavily incluso.
  • Memorizza la configurazione di Tavily in plugins.entries.tavily.config.webSearch.*.
  • web_search con Tavily supporta query e count (fino a 20 risultati).
  • Per controlli specifici di Tavily come search_depth, topic, include_answer o filtri di dominio, usa tavily_search.

​
Strumenti plugin Tavily

Usalo quando vuoi controlli di ricerca specifici di Tavily invece del web_search generico.
ParametroDescrizione
queryStringa di query di ricerca (mantienila sotto i 400 caratteri)
search_depthbasic (predefinito, bilanciato) o advanced (massima rilevanza, più lento)
topicgeneral (predefinito), news (aggiornamenti in tempo reale) o finance
max_resultsNumero di risultati, 1-20 (predefinito: 5)
include_answerInclude un riepilogo di risposta generato dall’IA (predefinito: false)
time_rangeFiltra per recenza: day, week, month o year
include_domainsArray di domini a cui limitare i risultati
exclude_domainsArray di domini da escludere dai risultati
Profondità di ricerca:
ProfonditàVelocitàRilevanzaIdeale per
basicPiù veloceAltaQuery per uso generale (predefinito)
advancedPiù lentoMassimaPrecisione, fatti specifici, ricerca

​
tavily_extract

Usalo per estrarre contenuti puliti da uno o più URL. Gestisce pagine renderizzate con JavaScript e supporta chunking focalizzato sulla query per un’estrazione mirata.
ParametroDescrizione
urlsArray di URL da estrarre (1-20 per richiesta)
queryRiordina i chunk estratti in base alla rilevanza per questa query
extract_depthbasic (predefinito, veloce) o advanced (per pagine ricche di JS)
chunks_per_sourceChunk per URL, 1-5 (richiede query)
include_imagesInclude gli URL delle immagini nei risultati (predefinito: false)
Profondità di estrazione:
ProfonditàQuando usarla
basicPagine semplici - prova prima questa
advancedSPA renderizzate in JS, contenuti dinamici, tabelle
Suggerimenti:
  • Massimo 20 URL per richiesta. Suddividi elenchi più lunghi in più chiamate.
  • Usa query + chunks_per_source per ottenere solo il contenuto rilevante invece delle pagine complete.
  • Prova prima basic; passa a advanced se il contenuto manca o è incompleto.

​
Scegliere lo strumento giusto

EsigenzaStrumento
Ricerca web rapida, senza opzioni specialiweb_search
Ricerca con profondità, argomento, risposte IAtavily_search
Estrarre contenuti da URL specificitavily_extract

​
Correlati