Tools

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 AI, 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'AI ed estrazione di contenuti dagli URL (incluse pagine renderizzate con JavaScript).

Ottieni una chiave API

Crea un account Tavily su tavily.com.
Genera una chiave API nella dashboard.
Salvala nella configurazione oppure imposta TAVILY_API_KEY nell'ambiente del Gateway.

Configura la ricerca Tavily

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // facoltativo se TAVILY_API_KEY è impostato
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

Note:

Scegliere Tavily durante l'onboarding o con openclaw configure --section web abilita automaticamente il Plugin Tavily incluso.
Salva la configurazione 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

`tavily_search`

Usalo quando vuoi controlli di ricerca specifici di Tavily invece del generico web_search.

Parametro	Descrizione
`query`	Stringa di query di ricerca (mantienila sotto i 400 caratteri)
`search_depth`	`basic` (predefinito, bilanciato) o `advanced` (massima rilevanza, più lento)
`topic`	`general` (predefinito), `news` (aggiornamenti in tempo reale) o `finance`
`max_results`	Numero di risultati, 1-20 (predefinito: 5)
`include_answer`	Includi un riepilogo della risposta generato dall'AI (predefinito: false)
`time_range`	Filtra per recenza: `day`, `week`, `month` o `year`
`include_domains`	Array di domini a cui limitare i risultati
`exclude_domains`	Array di domini da escludere dai risultati

Profondità di ricerca:

Profondità	Velocità	Rilevanza	Ideale per
`basic`	Più veloce	Alta	Query di uso generale (predefinito)
`advanced`	Più lento	Massima	Precisione, fatti specifici, ricerca

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

Parametro	Descrizione
`urls`	Array di URL da estrarre (1-20 per richiesta)
`query`	Rerank dei chunk estratti in base alla rilevanza per questa query
`extract_depth`	`basic` (predefinito, veloce) o `advanced` (per pagine ricche di JS)
`chunks_per_source`	Chunk per URL, 1-5 (richiede `query`)
`include_images`	Includi gli URL delle immagini nei risultati (predefinito: false)

Profondità di estrazione:

Profondità	Quando usarla
`basic`	Pagine semplici - prova prima questa
`advanced`	SPA renderizzate in JS, contenuti dinamici, tabelle

Suggerimenti:

Massimo 20 URL per richiesta. Suddividi elenchi più grandi in più chiamate.
Usa query + chunks_per_source per ottenere solo il contenuto rilevante invece di pagine complete.
Prova prima basic; passa a advanced se il contenuto manca o è incompleto.

Scegliere lo strumento giusto

Esigenza	Strumento
Ricerca web rapida, nessuna opzione speciale	`web_search`
Ricerca con profondità, argomento, risposte AI	`tavily_search`
Estrazione di contenuti da URL specifici	`tavily_extract`

Correlati

Panoramica Web Search -- tutti i provider e il rilevamento automatico
Firecrawl -- ricerca + scraping con estrazione dei contenuti
Exa Search -- ricerca neurale con estrazione dei contenuti

# Ottieni una chiave API

# Configura la ricerca Tavily

# Strumenti Plugin Tavily

# tavily_search

# tavily_extract

# Scegliere lo strumento giusto

# Correlati