Vai al contenuto principale
Tavily è un’API di ricerca progettata per applicazioni IA. OpenClaw la espone in due modi:
  • come provider web_search per lo strumento di ricerca generico
  • come strumenti Plugin espliciti: tavily_search e tavily_extract
Tavily restituisce risultati strutturati ottimizzati per il consumo da parte degli LLM, con profondità di ricerca configurabile, filtro per argomento, filtri di dominio, riepiloghi di risposta generati dall’IA ed estrazione di contenuti dagli URL (incluse le pagine renderizzate con JavaScript).
ProprietàValore
ID Plugintavily
Pacchetto@openclaw/tavily-plugin
AuthTAVILY_API_KEY o config apiKey
URL basehttps://api.tavily.com (predefinito)
Strumentitavily_search, tavily_extract

​
Per iniziare

1

Installa il plugin

openclaw plugins install @openclaw/tavily-plugin
2

Ottieni una chiave API

Crea un account Tavily su tavily.com, quindi genera una chiave API nella dashboard.
3

Configura il plugin e il provider

{
  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",
      },
    },
  },
}
4

Verifica che la ricerca venga eseguita

Attiva una web_search da qualsiasi agente, oppure chiama direttamente tavily_search.
Scegliere Tavily durante l’onboarding o con openclaw configure --section web installa e abilita il plugin ufficiale Tavily quando necessario.

​
Riferimento degli strumenti

Usalo quando vuoi controlli di ricerca specifici di Tavily invece di web_search generico.
ParametroTipoVincoli / predefinitoDescrizione
querystringobbligatorioStringa della query di ricerca. Mantienila sotto i 400 caratteri.
search_depthenumbasic (predefinito), advancedadvanced è più lento ma ha maggiore pertinenza.
topicenumgeneral (predefinito), news, financeFiltra per famiglia di argomenti.
max_resultsinteger1-20Numero di risultati.
include_answerbooleanpredefinito falseInclude un riepilogo della risposta generato dall’IA di Tavily.
time_rangeenumday, week, month, yearFiltra i risultati per recenza.
include_domainsstring array(nessuno)Include solo i risultati da questi domini.
exclude_domainsstring array(nessuno)Esclude i risultati da questi domini.
Compromesso della profondità di ricerca:
ProfonditàVelocitàPertinenzaIdeale per
basicPiù veloceAltaQuery generiche (predefinito).
advancedPiù lentaMassimaRicerca di precisione e verifica dei fatti.

​
tavily_extract

Usalo per estrarre contenuti puliti da uno o più URL. Gestisce pagine renderizzate con JavaScript e supporta il chunking focalizzato sulla query per un’estrazione mirata.
ParametroTipoVincoli / predefinitoDescrizione
urlsstring arrayobbligatorio, 1-20URL da cui estrarre contenuti.
querystring(opzionale)Riordina i chunk estratti in base alla pertinenza con questa query.
extract_depthenumbasic (predefinito), advancedUsa advanced per pagine con molto JS, SPA o tabelle dinamiche.
chunks_per_sourceinteger1-5; richiede queryChunk restituiti per URL. Genera errori se impostato senza query.
include_imagesbooleanpredefinito falseInclude gli URL delle immagini nei risultati.
Compromesso della profondità di estrazione:
ProfonditàQuando usarla
basicPagine semplici. Prova prima questa.
advancedSPA renderizzate con JS, contenuti dinamici, tabelle.
Dividi elenchi di URL più grandi in più chiamate tavily_extract (massimo 20 per richiesta). Usa query insieme a chunks_per_source per ottenere solo i contenuti pertinenti invece delle pagine complete.

​
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
Lo strumento generico web_search con Tavily come provider supporta query e count (fino a 20 risultati). Per i controlli specifici di Tavily (search_depth, topic, include_answer, filtri di dominio, intervallo temporale), usa invece tavily_search.

​
Configurazione avanzata

Il client Tavily cerca la propria chiave API in questo ordine:
  1. plugins.entries.tavily.config.webSearch.apiKey (risolto tramite SecretRefs).
  2. TAVILY_API_KEY dall’ambiente del gateway.
tavily_extract genera un errore di configurazione se nessuno dei due è presente.
Sovrascrivi plugins.entries.tavily.config.webSearch.baseUrl se instradi Tavily tramite un proxy. Il valore predefinito è https://api.tavily.com.
tavily_extract rifiuta le chiamate che passano chunks_per_source senza una query. Tavily classifica i chunk in base alla pertinenza della query, quindi il parametro non ha significato senza una query.

​
Correlati

Panoramica di Web Search

Tutti i provider e le regole di rilevamento automatico.

Firecrawl

Ricerca più scraping con estrazione di contenuti.

Exa Search

Ricerca neurale con estrazione di contenuti.

Configurazione

Schema di configurazione completo per le voci del plugin e l’instradamento degli strumenti.