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

Tools

Recherche Brave

OpenClaw prend en charge l’API Brave Search comme fournisseur de web_search.

Obtenir une clé d’API

  1. Créez un compte d’API Brave Search sur https://brave.com/search/api/
  2. Dans le tableau de bord, choisissez l’offre Search et générez une clé d’API.
  3. Stockez la clé dans la configuration ou définissez BRAVE_API_KEY dans l’environnement du Gateway.

Exemple de configuration

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // ou "llm-context"            baseUrl: "https://api.search.brave.com", // remplacement facultatif du proxy/de l’URL de base          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Les paramètres de recherche propres au fournisseur Brave se trouvent sous plugins.entries.brave.config.webSearch.* ; il s’agit du chemin de configuration canonique. Un paramètre partagé de premier niveau tools.web.search.apiKey et des paramètres délimités tools.web.search.brave.* sont toujours chargés au moyen d’une fusion de compatibilité, mais toute nouvelle configuration doit utiliser le chemin propre au Plugin indiqué ci-dessus.

webSearch.mode contrôle le mode de transport de Brave :

  • web (par défaut) : recherche web Brave normale avec titres, URL et extraits
  • llm-context : API Brave LLM Context avec des segments de texte préextraits et des sources pour l’ancrage factuel

webSearch.baseUrl permet d’acheminer les requêtes Brave vers un proxy ou un Gateway de confiance compatible avec Brave. OpenClaw ajoute /res/v1/web/search ou /res/v1/llm/context à l’URL de base configurée et conserve celle-ci dans la clé de cache. Les points de terminaison publics doivent utiliser https:// ; http:// n’est accepté que pour les hôtes proxy de confiance sur local loopback ou un réseau privé.

Paramètres de l’outil

querystringrequired

Requête de recherche.

countnumberdefault: 5

Nombre de résultats à renvoyer (1 à 10).

countrystring

Code pays ISO à 2 lettres (par ex. US, DE).

languagestring

Code de langue ISO 639-1 pour les résultats de recherche (par ex. en, de, fr).

search_langstring

Code de langue de recherche Brave (par ex. en, en-gb, zh-hans).

ui_langstring

Code de langue ISO pour les éléments de l’interface utilisateur.

freshness'day' | 'week' | 'month' | 'year'

Filtre temporel — day correspond à 24 heures.

date_afterstring

Uniquement les résultats publiés après cette date (YYYY-MM-DD).

date_beforestring

Uniquement les résultats publiés avant cette date (YYYY-MM-DD).

Exemples :

javascript
// Recherche propre à un pays et à une langueawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Résultats récents (semaine écoulée)await web_search({  query: "AI news",  freshness: "week",}); // Recherche sur une plage de datesawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Remarques

  • OpenClaw utilise l’offre Search de Brave. Si vous disposez d’un abonnement historique (par ex. l’offre Free d’origine avec 2 000 requêtes par mois), il reste valide, mais n’inclut pas les fonctionnalités plus récentes telles que LLM Context ni les limites de débit supérieures.
  • Chaque offre Brave inclut 5 $ de crédit gratuit par mois (renouvelé mensuellement). L’offre Search coûte 5 $ pour 1 000 requêtes ; le crédit couvre donc 1 000 requêtes par mois. Définissez votre limite d’utilisation dans le tableau de bord Brave afin d’éviter des frais inattendus. Consultez le portail de l’API Brave pour connaître les offres actuelles.
  • L’offre Search comprend le point de terminaison LLM Context et les droits d’inférence d’IA. Le stockage des résultats afin d’entraîner ou d’ajuster des modèles nécessite une offre accordant explicitement des droits de stockage. Consultez les conditions d’utilisation de Brave.
  • Le mode llm-context renvoie des entrées de sources ancrées au lieu du format d’extrait habituel de la recherche web.
  • Le mode llm-context prend en charge freshness ainsi que les plages bornées date_after + date_before. Il ne prend pas en charge ui_lang ; date_before sans date_after est rejeté, car Brave exige que les plages de fraîcheur personnalisées incluent une date de début et une date de fin.
  • ui_lang doit inclure un sous-tag de région, tel que en-US.
  • Par défaut, les résultats sont mis en cache pendant 15 minutes (durée configurable via cacheTtlMinutes).
  • Les valeurs personnalisées de webSearch.baseUrl sont incluses dans l’identité du cache Brave, afin que les réponses propres à chaque proxy n’entrent pas en collision.
  • Activez l’indicateur de diagnostic brave.http pour journaliser les URL et paramètres de requête Brave, l’état et la durée des réponses, ainsi que les événements de succès, d’échec et d’écriture du cache de recherche lors du dépannage. L’indicateur ne journalise jamais la clé d’API ni le corps des réponses, mais les requêtes de recherche peuvent être sensibles.

Voir aussi

Was this useful?
On this page

On this page