Skill Tavily Web Search pour OpenClaw

Présentation du Skill Tavily Web Search pour OpenClaw

Le skill Tavily Web Search connecte OpenClaw à l'API Tavily Search, un moteur de recherche optimisé pour l'IA, conçu spécifiquement pour les agents IA et les applications LLM. Contrairement aux API de recherche traditionnelles qui renvoient des liens bruts, Tavily analyse plusieurs sources et retourne un contenu structuré et pertinent que votre agent OpenClaw peut exploiter immédiatement.

Tavily alimente la recherche de plus d'un million de développeurs et traite plus de 100 millions de requêtes par mois. Il est utilisé par OpenAI, Anthropic, LangChain et d'autres plateformes IA de premier plan. Avec sa certification SOC 2, sa politique de rétention de données nulle et sa protection intégrée contre l'injection de prompt, c'est l'un des moyens les plus sûrs de donner à votre agent un accès au web.

Flux de travail typique :

1. Posez à OpenClaw une question nécessitant des informations à jour.
2. L'agent appelle l'API Tavily avec une requête optimisée.
3. Tavily parcourt le web, extrait le contenu pertinent de plusieurs sources et renvoie un résumé structuré avec citations — le tout en moins de 2 secondes.

Ce skill est idéal pour les tâches de recherche, la vérification de faits, le suivi de l'actualité et tout flux de travail où votre agent a besoin d'accéder à des informations au-delà de ses données d'entraînement. Il se combine parfaitement avec le skill Brave Search pour les requêtes axées sur la confidentialité et le skill DeepWiki pour la recherche dans la documentation de dépôts.

Prérequis pour le Skill Tavily Web Search

Avant d'installer le skill Tavily Web Search, assurez-vous d'avoir :

• OpenClaw installé et en cours d'exécution (v1.0+)
• Une clé API Tavily — inscrivez-vous sur tavily.com (le niveau gratuit inclut 1 000 crédits/mois)
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Confirmer que votre clé API Tavily est définie
echo $TAVILY_API_KEY

Aucune installation logicielle supplémentaire n'est requise. Le skill communique avec l'API cloud de Tavily, il n'y a donc aucune dépendance locale au-delà d'OpenClaw lui-même.

Comment Installer le Skill Tavily Web Search

Installez le skill Tavily Web Search avec une seule commande :

npx clawhub@latest install tavily-web-search

Pour vérifier l'installation :

clawhub list

Vous devriez voir tavily-web-search dans la liste des skills installés.

Configuration du Skill Tavily Web Search

Le skill nécessite une clé API Tavily pour l'authentification. Vous pouvez obtenir une clé gratuite sur app.tavily.com.

Configuration de la clé API

# Définir votre clé API Tavily comme variable d'environnement
export TAVILY_API_KEY=tvly-your-api-key-here

Pour rendre ce paramètre permanent, ajoutez la ligne d'export à votre profil shell (~/.bashrc, ~/.zshrc ou équivalent).

Modes de recherche

Le skill prend en charge deux profondeurs de recherche et deux modes thématiques que vous pouvez combiner selon vos besoins :

| Mode | Vitesse | Couverture | Idéal pour | |------|---------|------------|------------| | Basique | 1-2 secondes | Bonne | Faits rapides, recherches simples | | Avancé | 5-10 secondes | Excellente | Recherches complexes, réponses complètes |

| Thème | Portée | Idéal pour | |-------|--------|------------| | Général | Contenu web de tout temps | Sujets pérennes, documentation, tutoriels | | Actualités | 7 derniers jours, sources d'information | Événements actuels, dernières nouvelles, évolutions du marché |

L'agent sélectionne automatiquement le mode approprié en fonction de votre requête, mais vous pouvez le forcer en précisant « fais une recherche approfondie » ou « cherche dans les actualités récentes » dans votre prompt.

Important : Ne codez jamais votre clé API en dur dans les fichiers de configuration et ne la committez jamais dans le contrôle de version. Utilisez des variables d'environnement ou un gestionnaire de secrets comme 1Password.

Exemples d'Utilisation du Skill Tavily Web Search

1. Recherche rapide de faits

Vous : « Quelle est la dernière version stable de Next.js ? »

L'agent effectue une recherche Tavily basique, extrait le numéro de version depuis les sources officielles et renvoie une réponse concise avec un lien vers les notes de version de Next.js.

2. Recherche approfondie

Vous : « Compare les avantages et inconvénients du rendu côté serveur par rapport à la génération de sites statiques pour les sites e-commerce. »

L'agent effectue une recherche avancée, agrège les informations issues de plusieurs articles de blog, pages de documentation et études de cas, puis renvoie une comparaison structurée avec des citations pour chaque point.

3. Actualités et événements récents

Vous : « Que s'est-il passé dans l'industrie de l'IA cette semaine ? »

L'agent bascule en mode actualités, effectue une recherche sur les 7 derniers jours et renvoie un résumé des principales actualités IA avec des liens vers les articles originaux.

4. Recherche ciblée par domaine

Vous : « Cherche uniquement sur MDN et la documentation TypeScript comment utiliser les types littéraux de template. »

L'agent utilise le filtrage par domaine pour n'inclure que developer.mozilla.org et typescriptlang.org, garantissant que les résultats proviennent exclusivement de sources faisant autorité.

5. Extraction de contenu

Vous : « Extrais le contenu complet de la page de tarification de l'API Tavily et résume les différents niveaux. »

L'agent utilise l'extraction de contenu brut pour récupérer le contenu intégral de la page, puis produit un récapitulatif structuré de chaque niveau tarifaire avec ses fonctionnalités et ses limites.

Sécurité et Bonnes Pratiques

Suivez ces recommandations lors de l'utilisation du skill Tavily Web Search :

• Protégez votre clé API. Stockez-la dans une variable d'environnement ou un gestionnaire de secrets. Ne la partagez jamais dans les journaux de chat, ne la committez pas dans Git et ne l'exposez pas dans du code côté client.
• Traitez les résultats de recherche comme des données non fiables. Le contenu web peut contenir des informations inexactes, obsolètes ou manipulées. Vérifiez toujours les faits critiques auprès de plusieurs sources avant d'agir. Consultez la Liste de contrôle de sécurité pour des recommandations générales.
• Surveillez votre utilisation. Le niveau gratuit fournit 1 000 crédits par mois. Chaque recherche basique coûte 1 crédit, et les recherches avancées coûtent 2 crédits. Vérifiez votre consommation sur app.tavily.com pour éviter les dépassements inattendus.
• Utilisez le filtrage par domaine pour les requêtes sensibles. Lorsque la précision est importante, limitez les résultats aux domaines de confiance (documentation officielle, sites gouvernementaux, publications établies) à l'aide des filtres d'inclusion de domaine.
• Respectez les limites de débit. Évitez les requêtes rapides en boucle. Le skill gère les limitations de débit de manière élégante, mais des requêtes excessives peuvent temporairement restreindre votre accès.

Résolution des Erreurs Courantes

« Clé API invalide »

Votre clé API Tavily est manquante, mal formée ou expirée.

1. Vérifiez que la clé est définie : echo $TAVILY_API_KEY
2. Assurez-vous qu'elle commence par tvly- — les clés Tavily utilisent toujours ce préfixe.
3. Si la clé est correcte mais échoue toujours, générez-en une nouvelle sur app.tavily.com.

« Limite de débit dépassée »

Vous avez dépassé la limite de requêtes de votre niveau d'abonnement.

1. Vérifiez votre consommation actuelle sur app.tavily.com.
2. Si vous êtes sur le niveau gratuit, attendez la réinitialisation mensuelle le 1er du mois suivant.
3. Envisagez de passer à un plan payant pour des limites plus élevées, ou optimisez vos requêtes en utilisant le mode basique lorsque le mode avancé n'est pas nécessaire.

« Aucun résultat trouvé »

La requête n'a retourné aucun résultat correspondant. Cela peut se produire avec des recherches très spécialisées ou très spécifiques.

1. Élargissez vos termes de recherche — supprimez les filtres trop restrictifs.
2. Si vous utilisez le filtrage par domaine, assurez-vous que les domaines ciblés contiennent réellement du contenu pertinent.
3. Essayez de passer du mode actualités au mode général si le sujet ne concerne pas un événement récent.