OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Tavily

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 explicites du Plugin : tavily_search et tavily_extract

Tavily renvoie des résultats structurés optimisés pour être exploités par les LLM, avec une profondeur de recherche configurable, un filtrage par sujet, des filtres de domaines, des résumés de réponses générés par l’IA et l’extraction de contenu à partir d’URL (y compris les pages rendues en JavaScript).

Propriété Valeur
ID du Plugin tavily
Paquet @openclaw/tavily-plugin
Authentification variable d’environnement TAVILY_API_KEY ou configuration apiKey
URL de base https://api.tavily.com (par défaut) ; variable d’environnement TAVILY_BASE_URL ou configuration baseUrl pour la remplacer
Délais d’expiration 30 s pour la recherche, 60 s pour l’extraction (par défaut)
Outils tavily_search, tavily_extract

Prise en main

  • Installer le Plugin

    bash
    openclaw plugins install @openclaw/tavily-plugin

  • Obtenir une clé d’API

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

  • Configurer le Plugin et le fournisseur

    json5
    {  plugins: {    entries: {      tavily: {        enabled: true,        config: {          webSearch: {            apiKey: "tvly-...", // facultatif si TAVILY_API_KEY est défini            baseUrl: "https://api.tavily.com",          },        },      },    },  },  tools: {    web: {      search: {        provider: "tavily",      },    },  },}

  • Vérifier l’exécution des recherches

    Déclenchez une recherche web_search depuis n’importe quel agent, ou appelez directement tavily_search.

    • Référence des outils

    Utilisez cet outil lorsque vous souhaitez disposer des options de recherche propres à Tavily plutôt que de l’outil générique web_search.

    Paramètre Type Contraintes / valeur par défaut Description
    query chaîne de caractères obligatoire Chaîne de la requête de recherche.
    search_depth énumération basic (par défaut), advanced advanced est plus lent, mais offre une meilleure pertinence.
    topic énumération general (par défaut), news, finance Filtre par famille de sujets.
    max_results entier 1 à 20, 5 par défaut Nombre de résultats.
    include_answer booléen false par défaut Inclut un résumé de réponse généré par l’IA de Tavily.
    time_range énumération day, week, month, year Filtre les résultats selon leur récence.
    include_domains tableau de chaînes (aucun) Inclut uniquement les résultats provenant de ces domaines.
    exclude_domains tableau de chaînes (aucun) Exclut les résultats provenant de ces domaines.

    Compromis lié à la profondeur de recherche :

    Profondeur Vitesse Pertinence Idéal pour
    basic Plus rapide Élevée Requêtes générales (par défaut).
    advanced Plus lent Maximale Recherches de précision et vérification de faits.

    tavily_extract

    Utilisez cet outil pour extraire du contenu épuré à partir d’une ou de plusieurs URL. Il prend en charge les pages rendues en JavaScript et le découpage ciblé selon une requête pour une extraction précise.

    Paramètre Type Contraintes / valeur par défaut Description
    urls tableau de chaînes obligatoire, 1 à 20 URL dont le contenu doit être extrait.
    query chaîne de caractères (facultatif) Reclasse les fragments extraits selon leur pertinence pour cette requête.
    extract_depth énumération basic (par défaut), advanced Utilisez advanced pour les pages riches en JS, les SPA ou les tableaux dynamiques.
    chunks_per_source entier 1 à 5 ; nécessite query Nombre de fragments renvoyés par URL. Génère une erreur s’il est défini sans query.
    include_images booléen false par défaut Inclut les URL des images dans les résultats.

    Compromis lié à la profondeur d’extraction :

    Profondeur Quand l’utiliser
    basic Pages simples. Essayez d’abord cette option.
    advanced SPA rendues en JS, contenu dynamique et tableaux.

    Choisir le bon outil

    Besoin Outil
    Recherche web rapide, sans option particulière web_search
    Recherche avec profondeur, sujet et réponses de l’IA tavily_search
    Extraction du contenu d’URL précises tavily_extract

    Configuration avancée

    Ordre de résolution de la clé d’API

    Le client Tavily recherche sa clé d’API dans l’ordre suivant :

    1. plugins.entries.tavily.config.webSearch.apiKey (résolue au moyen de SecretRefs).
    2. TAVILY_API_KEY dans l’environnement du Gateway.

    tavily_search et tavily_extract génèrent tous deux une erreur de configuration si aucune des deux n’est présente.

    URL de base personnalisée

    Remplacez plugins.entries.tavily.config.webSearch.baseUrl, ou définissez TAVILY_BASE_URL, si vous faites transiter Tavily par un proxy. La configuration est prioritaire sur la variable d’environnement. La valeur par défaut est https://api.tavily.com.

    `chunks_per_source` nécessite `query`

    tavily_extract rejette les appels qui transmettent chunks_per_source sans query. Tavily classe les fragments selon leur pertinence par rapport à la requête ; ce paramètre n’a donc aucun sens sans requête.

    Rubriques connexes

    Présentation de la recherche web

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

    Recherche et collecte de données avec extraction de contenu.
    Recherche Exa

    Recherche neuronale avec extraction de contenu.
    Configuration

    Schéma de configuration complet des entrées de Plugins et du routage des outils.
    Was this useful?
    On this page

    On this page