Brave Search et OpenClaw : configurer la recherche web

Introduction

Brave Search OpenClaw est utile quand un agent doit trouver des informations web récentes et retourner des sources structurées. Brave s'intègre comme fournisseur de l'outil natif web_search, pas comme classe Python. Pour une recherche ponctuelle sans clé ou un simple lien déjà connu, une option plus simple peut suffire : évitez d'ajouter un fournisseur payant sans besoin mesuré.

Configurez Brave, rendez web_search disponible dans la politique d'outils et testez une requête. Un skill Markdown peut ensuite enseigner une méthode de veille, mais il ne remplace pas l'outil et ne contient pas le client HTTP. Ce guide couvre la configuration, l'autorisation, la validation des résultats et le passage en production. Si vous découvrez ce modèle, lisez comprendre les skills OpenClaw.

Résumé rapide

1. Obtenez une clé Brave Search API auprès de Brave.
2. Lancez openclaw configure --section web et sélectionnez Brave.
3. Vous pouvez aussi exposer BRAVE_API_KEY au processus Gateway.
4. Vérifiez que web_search ou group:web est autorisé pour l'agent concerné.
5. Testez depuis le chat avec une demande précise et contrôlez les sources retournées.
6. Ne créez un SKILL.md que pour formaliser une procédure de recherche récurrente.

La tarification et les quotas de Brave peuvent évoluer. Consultez le tableau de bord du fournisseur avant d'estimer un coût ; ce guide ne reprend pas de quota promotionnel susceptible de devenir obsolète.

Ce que Brave Search représente dans OpenClaw

OpenClaw sépare plusieurs couches qu'il est facile de confondre :

Couche	Rôle dans ce parcours
Outil	web_search reçoit une requête et retourne une réponse normalisée.
Fournisseur	Brave exécute la recherche lorsque provider: "brave" est sélectionné.
Plugin	Le fournisseur Brave appartient à la surface d'extension d'OpenClaw ; sa configuration se trouve sous l'entrée de plugin correspondante.
Skill	Un SKILL.md explique quand chercher, comment filtrer et comment restituer les sources.
Script	Un programme local peut préparer une requête ou traiter une sortie, sans devenir pour autant un skill ou un plugin.
Canal	Slack, Telegram ou le Control UI transportent la conversation ; ils ne réalisent pas la recherche.

L'outil normalise les réponses des fournisseurs. Pour Brave, vous obtenez notamment un ensemble de résultats avec titre, URL et extrait. Le contenu externe reste non fiable par défaut : l'agent doit vérifier les pages avant d'en tirer une conclusion. web_fetch sert à lire une URL légère ; le navigateur est préférable pour une page riche en JavaScript. Cette séparation est utile dans un agent de recherche avec OpenClaw.

Configurer Brave Search

Parcours recommandé avec l'assistant

Dans le terminal qui gère votre installation OpenClaw, lancez :

openclaw configure --section web

Sélectionnez Brave puis saisissez la clé dans le parcours masqué. Cette voie limite les erreurs de nom de fournisseur ou de chemin de configuration. Redémarrez le Gateway si l'assistant vous le demande, puis contrôlez son état :

openclaw gateway status

Variante par variable d'environnement

OpenClaw reconnaît la variable suivante dans l'environnement du processus Gateway :

export BRAVE_API_KEY="votre-cle"

Pour un Gateway installé comme service, placez la variable dans le mécanisme d'environnement prévu par votre installation, puis redémarrez le service. Une variable exportée uniquement dans un shell différent n'est pas nécessairement visible du processus déjà lancé.

Configuration explicite du fournisseur

La configuration actuelle vit dans ~/.openclaw/openclaw.json. Une forme JSON5 officiellement documentée consiste à sélectionner Brave pour la recherche :

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
    },
  },
}

La clé peut être enregistrée par l'assistant de configuration ou fournie par BRAVE_API_KEY. N'inventez pas de fichier openclaw.yaml : ce n'est pas la configuration principale du produit actuel.

Autoriser et utiliser l'outil

Si votre politique d'outils est restrictive, autorisez explicitement la recherche :

{
  tools: {
    allow: ["web_search"],
  },
}

Vous pouvez aussi autoriser group:web lorsque l'agent doit disposer de web_search, x_search et web_fetch. Choisissez la portée la plus étroite compatible avec le besoin. Une allowlist détermine ce qui est exposé au modèle ; elle ne dispense pas de contrôler les sorties et les effets de bord.

Pour le premier test, ouvrez le Control UI ou votre canal habituel et demandez :

Recherche les mises à jour OpenClaw publiées cette semaine. Retourne cinq sources avec leur date, puis sépare les faits confirmés des interprétations.

Les paramètres documentés de web_search couvrent notamment le nombre de résultats, le pays, la langue et la fraîcheur. Le modèle peut les renseigner à partir de votre demande. Une requête précise donne généralement un meilleur résultat qu'une consigne vague telle que « cherche les news IA ».

Pour diagnostiquer une absence de recherche, vérifiez successivement la présence de la clé dans le processus Gateway, le fournisseur sélectionné, la politique d'outils et les journaux. openclaw doctor permet aussi de repérer une configuration invalide.

Avant d'automatiser, construisez une matrice de test courte. Essayez une requête générale, une requête française avec filtre de langue, une période récente et un mot-clé ne donnant aucun résultat. Vérifiez que la sortie indique toujours le fournisseur, la requête et le nombre de résultats, et qu'une erreur de credential reste une erreur visible. Ne demandez jamais au modèle de « compléter de mémoire » lorsqu'une recherche échoue.

Pour la production, surveillez le taux d'erreur, les latences, les appels par routine et la proportion de résultats réellement ouverts. La cache de recherche réduit les appels identiques pendant sa durée de vie, mais elle ne garantit pas la fraîcheur d'une page déjà récupérée. Lorsque l'actualité est déterminante, exigez une date ou une vérification sur la source primaire. Le panorama des outils pour agents IA aide à comparer cette recherche avec des briques d'extraction plus spécialisées.

Exemple concret

Supposons que vous prépariez chaque lundi une veille sur les frameworks d'agents IA. Le workflow minimal tient en quatre étapes :

1. web_search cherche les annonces sur une période courte.
2. L'agent élimine les doublons et privilégie les sources primaires.
3. web_fetch ouvre les pages retenues pour vérifier les affirmations importantes.
4. L'agent produit une note avec faits, incertitudes et liens de vérification.

Vous pouvez formaliser cette méthode dans un skill Markdown de workspace :

~/.openclaw/workspace/skills/veille-web/SKILL.md

Ce fichier décrit la procédure et demande l'usage de web_search. Il ne définit aucune classe Python et n'embarque pas un second client Brave. Testez ensuite la procédure avec :

openclaw agent --message "Prépare la veille web selon la méthode veille-web"

Ce modèle s'intègre à une automatisation récurrente seulement après avoir validé manuellement le résultat. La recherche planifiée doit conserver des limites de volume, un délai d'expiration et une destination de livraison claire. Le cas complet est détaillé dans OpenClaw veille IA.

Ajoutez un jeu de contrôle composé de trois sujets dont vous connaissez déjà les sources de référence. Après une modification de configuration ou une mise à jour d'OpenClaw, rejouez ces demandes et comparez le fournisseur utilisé, les domaines retenus et les dates. Une régression de pertinence ne provoque pas toujours une erreur technique ; ce test éditorial la rend observable. Si la qualité baisse, réduisez la requête, ajustez la langue ou changez explicitement de fournisseur plutôt que d'empiler des règles dans le skill.

Bonnes pratiques

• Séparez recherche et lecture. Un extrait de moteur n'est pas la preuve complète ; ouvrez les sources déterminantes.
• Demandez des sources primaires. Documentation, dépôt et annonce officielle valent mieux qu'une chaîne de reprises.
• Bornez le volume. Cinq résultats bien ciblés sont souvent plus utiles que vingt extraits redondants.
• Traitez le web comme non fiable. Une page peut contenir des instructions malveillantes destinées à détourner l'agent.
• Protégez la clé. Ne la placez ni dans un prompt, ni dans un SKILL.md, ni dans le dépôt du workspace.
• Mesurez les appels réels. Le coût dépend du fournisseur, de votre plan et de la fréquence ; ne partez pas d'une estimation générique.
• Gardez un mode dégradé. Une recherche indisponible doit produire un échec visible, pas une synthèse présentée comme actuelle.

Le guide des API externes dans OpenClaw reste utile pour comprendre les extensions, à condition de distinguer un véritable plugin TypeScript d'un simple script local.

Questions fréquentes

Brave Search est-il un skill OpenClaw ?

Non. Dans le produit actuel, Brave est un fournisseur de l'outil web_search. Un skill peut apprendre à l'agent une méthode de recherche, mais il ne constitue pas l'intégration réseau elle-même.

Faut-il installer Python ou requests ?

Non pour ce parcours. La recherche est fournie par OpenClaw. Les exemples historiques basés sur BaseSkill, SkillOutput ou un objet Agent ne correspondent pas à l'API officielle actuelle.

Comment forcer Brave plutôt que l'auto-détection ?

Sélectionnez Brave avec openclaw configure --section web ou définissez explicitement tools.web.search.provider: "brave" dans openclaw.json.

Peut-on ajouter une méthode éditoriale personnalisée ?

Oui. Créez un SKILL.md qui décrit les requêtes, critères de sélection et règles de citation. Autorisez séparément web_search dans la politique d'outils.

Articles liés

La recherche web devient fiable lorsqu'elle sépare découverte, ouverture des pages et synthèse. Poursuivez avec ces guides pour construire une veille complète sans confondre outil exécutable et skill d'instructions.

• OpenClaw veille IA : use case complet
• Comprendre les skills OpenClaw
• Exemples de skills OpenClaw prêts à adapter
• Créer un agent de recherche avec OpenClaw
• Utiliser des API externes dans OpenClaw
• Créer un agent IA étape par étape