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.

Tavily è un’API di ricerca progettata per applicazioni di IA. OpenClaw la espone in due modi:
  • come provider web_search per lo strumento di ricerca generico
  • come strumenti espliciti del Plugin: 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 risposte generati dall’IA ed estrazione di contenuti dagli URL (incluse le pagine renderizzate con JavaScript).
ProprietàValore
ID Plugintavily
AutenticazioneTAVILY_API_KEY o config apiKey
URL di basehttps://api.tavily.com (predefinito)
Strumenti inclusitavily_search, tavily_extract

​
Per iniziare

1

Ottieni una chiave API

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

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",
      },
    },
  },
}
3

Verifica l'esecuzione della ricerca

Attiva una web_search da qualsiasi agente oppure chiama direttamente tavily_search.
Scegliere Tavily durante l’onboarding o con openclaw configure --section web abilita automaticamente il Plugin Tavily incluso.

​
Riferimento degli strumenti

Usalo quando vuoi controlli di ricerca specifici di Tavily invece della web_search generica.
ParametroTipoVincoli / predefinitoDescrizione
querystringobbligatorioStringa della query di ricerca. Mantienila sotto i 400 caratteri.
search_depthenumbasic (predefinito), advancedadvanced è più lento ma offre maggiore rilevanza.
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 risultati da questi domini.
exclude_domainsstring array(nessuno)Esclude i risultati da questi domini.
Compromesso della profondità di ricerca:
ProfonditàVelocitàRilevanzaIdeale 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 la suddivisione in blocchi focalizzata sulla query per un’estrazione mirata.
ParametroTipoVincoli / predefinitoDescrizione
urlsstring arrayobbligatorio, 1-20URL da cui estrarre contenuti.
querystring(facoltativo)Riordina i blocchi estratti in base alla rilevanza rispetto a questa query.
extract_depthenumbasic (predefinito), advancedUsa advanced per pagine con molto JS, SPA o tabelle dinamiche.
chunks_per_sourceinteger1-5; richiede queryBlocchi restituiti per URL. Genera un errore se impostato senza query.
include_imagesbooleanpredefinito falseInclude gli URL delle immagini nei risultati.
Compromesso della profondità di estrazione:
ProfonditàQuando usarla
basicPagine semplici. Provala per prima.
advancedSPA renderizzate con JS, contenuti dinamici, tabelle.
Suddividi elenchi di URL più grandi in più chiamate tavily_extract (massimo 20 per richiesta). Usa query insieme a chunks_per_source per ottenere solo contenuti pertinenti invece di 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 sua chiave API in questo ordine:
  1. plugins.entries.tavily.config.webSearch.apiKey (risolta tramite SecretRefs).
  2. TAVILY_API_KEY dall’ambiente del Gateway.
tavily_extract genera un errore di configurazione se non è presente nessuna delle due.
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 blocchi in base alla rilevanza rispetto alla 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 il routing degli strumenti.