Tools
Tavily
Tavily è un'API di ricerca progettata per applicazioni IA. OpenClaw la espone in due modi:
- come provider
web_searchper lo strumento di ricerca generico - come strumenti Plugin espliciti:
tavily_searchetavily_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 Plugin | tavily |
| Pacchetto | @openclaw/tavily-plugin |
| Auth | TAVILY_API_KEY o config apiKey |
| URL base | https://api.tavily.com (predefinito) |
| Strumenti | tavily_search, tavily_extract |
Per iniziare
Installa il plugin
openclaw plugins install @openclaw/tavily-pluginOttieni una chiave API
Crea un account Tavily su tavily.com, quindi genera una chiave API nella dashboard.
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", }, }, },}Verifica che la ricerca venga eseguita
Attiva una web_search da qualsiasi agente, oppure chiama direttamente tavily_search.
Riferimento degli strumenti
tavily_search
Usalo quando vuoi controlli di ricerca specifici di Tavily invece di web_search generico.
| Parametro | Tipo | Vincoli / predefinito | Descrizione |
|---|---|---|---|
query |
string | obbligatorio | Stringa della query di ricerca. Mantienila sotto i 400 caratteri. |
search_depth |
enum | basic (predefinito), advanced |
advanced è più lento ma ha maggiore pertinenza. |
topic |
enum | general (predefinito), news, finance |
Filtra per famiglia di argomenti. |
max_results |
integer | 1-20 | Numero di risultati. |
include_answer |
boolean | predefinito false |
Include un riepilogo della risposta generato dall'IA di Tavily. |
time_range |
enum | day, week, month, year |
Filtra i risultati per recenza. |
include_domains |
string array | (nessuno) | Include solo i risultati da questi domini. |
exclude_domains |
string array | (nessuno) | Esclude i risultati da questi domini. |
Compromesso della profondità di ricerca:
| Profondità | Velocità | Pertinenza | Ideale per |
|---|---|---|---|
basic |
Più veloce | Alta | Query generiche (predefinito). |
advanced |
Più lenta | Massima | Ricerca 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.
| Parametro | Tipo | Vincoli / predefinito | Descrizione |
|---|---|---|---|
urls |
string array | obbligatorio, 1-20 | URL da cui estrarre contenuti. |
query |
string | (opzionale) | Riordina i chunk estratti in base alla pertinenza con questa query. |
extract_depth |
enum | basic (predefinito), advanced |
Usa advanced per pagine con molto JS, SPA o tabelle dinamiche. |
chunks_per_source |
integer | 1-5; richiede query |
Chunk restituiti per URL. Genera errori se impostato senza query. |
include_images |
boolean | predefinito false |
Include gli URL delle immagini nei risultati. |
Compromesso della profondità di estrazione:
| Profondità | Quando usarla |
|---|---|
basic |
Pagine semplici. Prova prima questa. |
advanced |
SPA renderizzate con JS, contenuti dinamici, tabelle. |
Scegliere lo strumento giusto
| Esigenza | Strumento |
|---|---|
| Ricerca web rapida, senza opzioni speciali | web_search |
| Ricerca con profondità, argomento, risposte IA | tavily_search |
| Estrarre contenuti da URL specifici | tavily_extract |
Configurazione avanzata
Ordine di risoluzione della chiave API
Il client Tavily cerca la propria chiave API in questo ordine:
plugins.entries.tavily.config.webSearch.apiKey(risolto tramite SecretRefs).TAVILY_API_KEYdall'ambiente del gateway.
tavily_extract genera un errore di configurazione se nessuno dei due è presente.
URL base personalizzato
Sovrascrivi plugins.entries.tavily.config.webSearch.baseUrl se instradi Tavily tramite un proxy. Il valore predefinito è https://api.tavily.com.
`chunks_per_source` richiede `query`
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
Tutti i provider e le regole di rilevamento automatico.
Ricerca più scraping con estrazione di contenuti.
Ricerca neurale con estrazione di contenuti.
Schema di configurazione completo per le voci del plugin e l'instradamento degli strumenti.
