Passer au contenu principal

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 est une API de recherche conçue pour les applications d’IA. OpenClaw l’expose de deux manières :
  • 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 une profondeur de recherche configurable, un filtrage par sujet, des filtres de domaine, des résumés de réponse générés par l’IA et l’extraction de contenu depuis des URL (y compris les pages rendues par JavaScript).
PropriétéValeur
ID du Plugintavily
AuthentificationTAVILY_API_KEY or config apiKey
URL de basehttps://api.tavily.com (par défaut)
Outils groupéstavily_search, tavily_extract

​
Premiers pas

1

Obtenir une clé API

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

Configurer le plugin et le fournisseur

{
  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

Vérifier que la recherche s’exécute

Déclenchez un web_search depuis n’importe quel agent, ou appelez directement tavily_search.
Choisir Tavily lors de l’intégration ou avec openclaw configure --section web active automatiquement le plugin Tavily groupé.

​
Référence des outils

Utilisez ceci lorsque vous voulez des contrôles de recherche propres à Tavily au lieu de web_search générique.
ParamètreTypeContraintes / valeur par défautDescription
querystringrequisChaîne de requête de recherche. Gardez-la sous 400 caractères.
search_depthenumbasic (par défaut), advancedadvanced est plus lent mais plus pertinent.
topicenumgeneral (par défaut), news, financeFiltrer par famille de sujets.
max_resultsinteger1-20Nombre de résultats.
include_answerbooleanpar défaut falseInclure un résumé de réponse généré par l’IA de Tavily.
time_rangeenumday, week, month, yearFiltrer les résultats par récence.
include_domainsstring array(aucun)Inclure uniquement les résultats de ces domaines.
exclude_domainsstring array(aucun)Exclure les résultats de ces domaines.
Compromis de profondeur de recherche :
ProfondeurVitessePertinenceIdéal pour
basicPlus rapideÉlevéeRequêtes polyvalentes (par défaut).
advancedPlus lentMaximaleRecherche précise et vérification des faits.

​
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 ciblée.
ParamètreTypeContraintes / valeur par défautDescription
urlsstring arrayrequis, 1-20URL depuis lesquelles extraire le contenu.
querystring(facultatif)Reclasser les fragments extraits selon leur pertinence pour cette requête.
extract_depthenumbasic (par défaut), advancedUtilisez advanced pour les pages riches en JS, les SPA ou les tableaux dynamiques.
chunks_per_sourceinteger1-5 ; nécessite queryFragments renvoyés par URL. Génère une erreur si défini sans query.
include_imagesbooleanpar défaut falseInclure 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.
Répartissez les listes d’URL plus longues dans 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 particulièresweb_search
Recherche avec profondeur, sujet, réponses IAtavily_search
Extraire du contenu depuis des URL spécifiquestavily_extract
L’outil web_search générique 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 domaine, 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ésolu via SecretRefs).
  2. TAVILY_API_KEY depuis l’environnement du gateway.
tavily_extract génère une erreur de configuration si aucun des deux n’est présent.
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 passent chunks_per_source sans query. Tavily classe les fragments selon leur pertinence pour la requête, donc le paramètre n’a aucun sens sans requête.

​
Connexe

Vue d’ensemble de Web Search

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

Firecrawl

Recherche avec scraping et 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.