Passer au contenu principal

​
Tavily

OpenClaw peut utiliser Tavily de deux façons :
  • comme fournisseur web_search
  • comme outils de plugin explicites : tavily_search et tavily_extract
Tavily est une API de recherche conçue pour les applications d’IA, qui renvoie des résultats structurés optimisés pour la consommation par les LLM. Elle prend en charge une profondeur de recherche configurable, le filtrage par sujet, les filtres de domaine, les résumés de réponse générés par l’IA, ainsi que l’extraction de contenu à partir d’URL (y compris les pages rendues en JavaScript).

​
Obtenir une clé API

  1. Créez un compte Tavily sur tavily.com.
  2. Générez une clé API dans le tableau de bord.
  3. Stockez-la dans la configuration ou définissez TAVILY_API_KEY dans l’environnement de la gateway.

​
Configurer la recherche Tavily

{
  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",
      },
    },
  },
}
Remarques :
  • Choisir Tavily dans l’onboarding ou via openclaw configure --section web active automatiquement le plugin Tavily intégré.
  • Stockez la configuration Tavily sous plugins.entries.tavily.config.webSearch.*.
  • web_search avec Tavily prend en charge query et count (jusqu’à 20 résultats).
  • Pour les contrôles spécifiques à Tavily comme search_depth, topic, include_answer, ou les filtres de domaine, utilisez tavily_search.

​
Outils du plugin Tavily

Utilisez-le lorsque vous souhaitez des contrôles de recherche spécifiques à Tavily plutôt que le web_search générique.
ParamètreDescription
queryChaîne de requête de recherche (à garder sous 400 caractères)
search_depthbasic (par défaut, équilibré) ou advanced (pertinence maximale, plus lent)
topicgeneral (par défaut), news (mises à jour en temps réel) ou finance
max_resultsNombre de résultats, 1-20 (par défaut : 5)
include_answerInclure un résumé de réponse généré par l’IA (par défaut : false)
time_rangeFiltrer par récence : day, week, month ou year
include_domainsTableau de domaines auxquels limiter les résultats
exclude_domainsTableau de domaines à exclure des résultats
Profondeur de recherche :
ProfondeurVitessePertinenceIdéal pour
basicPlus rapideÉlevéeRequêtes générales (par défaut)
advancedPlus lentMaximalePrécision, faits spécifiques, recherche

​
tavily_extract

Utilisez-le pour extraire du contenu propre à partir d’une ou plusieurs URL. Gère les pages rendues en JavaScript et prend en charge le découpage orienté requête pour une extraction ciblée.
ParamètreDescription
urlsTableau d’URL à extraire (1-20 par requête)
queryRéordonner les segments extraits selon leur pertinence par rapport à cette requête
extract_depthbasic (par défaut, rapide) ou advanced (pour les pages fortement basées sur JS)
chunks_per_sourceSegments par URL, 1-5 (nécessite query)
include_imagesInclure les URL d’image dans les résultats (par défaut : false)
Profondeur d’extraction :
ProfondeurQuand l’utiliser
basicPages simples - à essayer en premier
advancedSPA rendues en JS, contenu dynamique, tableaux
Conseils :
  • Maximum 20 URL par requête. Répartissez les listes plus longues en plusieurs appels.
  • Utilisez query + chunks_per_source pour n’obtenir que le contenu pertinent au lieu de pages complètes.
  • Essayez d’abord basic ; utilisez advanced en repli si le contenu est manquant ou incomplet.

​
Choisir le bon outil

BesoinOutil
Recherche web rapide, sans options spécialesweb_search
Recherche avec profondeur, sujet, réponses IAtavily_search
Extraire du contenu à partir d’URL spécifiquestavily_extract

​
Lié