Passer au contenu principal
Tavily est une API de recherche conçue pour les applications d’IA. OpenClaw l’expose de deux façons :
  • comme fournisseur web_search pour l’outil de recherche générique
  • comme outils de Plugin explicites : tavily_search et tavily_extract
Tavily renvoie des résultats structurés optimisés pour la consommation par les LLM, avec profondeur de recherche configurable, filtrage par sujet, filtres de domaines, résumés de réponse générés par IA et extraction de contenu à partir d’URL (y compris les pages rendues par JavaScript).
PropriétéValeur
ID du Plugintavily
Package@openclaw/tavily-plugin
AuthentificationTAVILY_API_KEY ou config apiKey
URL de basehttps://api.tavily.com (par défaut)
Outilstavily_search, tavily_extract

​
Bien démarrer

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

Créez un compte Tavily sur tavily.com, puis générez une clé API dans le tableau de bord.
3

Configure the plugin and 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

Verify search runs

Déclenchez une recherche web_search depuis n’importe quel agent, ou appelez directement tavily_search.
Choisir Tavily pendant l’intégration ou avec openclaw configure --section web installe et active le Plugin officiel Tavily si nécessaire.

​
Référence des outils

Utilisez ceci lorsque vous voulez des contrôles de recherche propres à Tavily au lieu du web_search générique.
ParamètreTypeContraintes / valeur par défautDescription
querychaînerequisChaîne de requête de recherche. Restez sous 400 caractères.
search_depthénumérationbasic (par défaut), advancedadvanced est plus lent mais plus pertinent.
topicénumérationgeneral (par défaut), news, financeFiltrer par famille de sujets.
max_resultsentier1-20Nombre de résultats.
include_answerbooléenfalse par défautInclure un résumé de réponse généré par l’IA de Tavily.
time_rangeénumérationday, week, month, yearFiltrer les résultats par récence.
include_domainstableau de chaînes(aucun)Inclure uniquement les résultats de ces domaines.
exclude_domainstableau de chaînes(aucun)Exclure les résultats de ces domaines.
Compromis de profondeur de recherche :
ProfondeurVitessePertinenceIdéal pour
basicPlus rapideÉlevéeRequêtes généralistes (par défaut).
advancedPlus lenteMaximaleRecherche précise et vérification factuelle.

​
tavily_extract

Utilisez ceci pour extraire du contenu propre depuis une ou plusieurs URL. Gère les pages rendues par JavaScript et prend en charge le découpage ciblé par requête pour une extraction précise.
ParamètreTypeContraintes / valeur par défautDescription
urlstableau de chaînesrequis, 1-20URL depuis lesquelles extraire le contenu.
querychaîne(facultatif)Réordonner les fragments extraits selon leur pertinence pour cette requête.
extract_depthénumérationbasic (par défaut), advancedUtilisez advanced pour les pages chargées en JS, les SPA ou les tableaux dynamiques.
chunks_per_sourceentier1-5 ; requiert queryFragments renvoyés par URL. Erreur si défini sans query.
include_imagesbooléenfalse par défautInclure les URL d’images dans les résultats.
Compromis de profondeur d’extraction :
ProfondeurQuand l’utiliser
basicPages simples. Essayez ceci en premier.
advancedSPA rendues par JS, contenu dynamique, tableaux.
Regroupez les grandes listes d’URL en plusieurs appels tavily_extract (20 maximum par requête). Utilisez query avec chunks_per_source pour obtenir uniquement le contenu pertinent au lieu de pages complètes.

​
Choisir le bon outil

BesoinOutil
Recherche web rapide, sans options spécialesweb_search
Recherche avec profondeur, sujet, réponses IAtavily_search
Extraire le contenu d’URL spécifiquestavily_extract
L’outil générique web_search avec Tavily comme fournisseur prend en charge query et count (jusqu’à 20 résultats). Pour les contrôles propres à Tavily (search_depth, topic, include_answer, filtres de domaines, plage temporelle), utilisez plutôt tavily_search.

​
Configuration avancée

Le client Tavily recherche sa clé API dans cet ordre :
  1. plugins.entries.tavily.config.webSearch.apiKey (résolue via SecretRefs).
  2. TAVILY_API_KEY depuis l’environnement du Gateway.
tavily_extract génère une erreur de configuration si aucune des deux n’est présente.
Remplacez plugins.entries.tavily.config.webSearch.baseUrl si vous faites passer Tavily par un proxy. La valeur par défaut est https://api.tavily.com.
tavily_extract rejette les appels qui transmettent chunks_per_source sans query. Tavily classe les fragments selon leur pertinence par rapport à la requête, donc ce paramètre n’a pas de sens sans requête.

​
Connexe

Web Search overview

Tous les fournisseurs et règles de détection automatique.

Firecrawl

Recherche plus scraping avec extraction de contenu.

Exa Search

Recherche neuronale avec extraction de contenu.

Configuration

Schéma de configuration complet pour les entrées de Plugin et le routage des outils.