Recherche Brave

API de recherche Brave

OpenClaw prend en charge l’API de recherche Brave en tant que fournisseur web_search.

Obtenir une clé API

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

Exemple de configuration

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

Les paramètres de recherche Brave spécifiques au fournisseur se trouvent désormais sous plugins.entries.brave.config.webSearch.*. L’ancien tools.web.search.apiKey se charge toujours via le shim de compatibilité, mais ce n’est plus le chemin de configuration canonique.

Paramètres de l’outil

Paramètre	Description
query	Requête de recherche (requis)
count	Nombre de résultats à renvoyer (1-10, par défaut : 5)
country	Code de pays ISO à 2 lettres (par exemple, “US”, “DE”)
language	Code de langue ISO 639-1 pour les résultats de recherche (par exemple, “en”, “de”, “fr”)
ui_lang	Code de langue ISO pour les éléments de l’interface utilisateur
freshness	Filtre temporel : day (24h), week, month ou year
date_after	Uniquement les résultats publiés après cette date (YYYY-MM-DD)
date_before	Uniquement les résultats publiés avant cette date (YYYY-MM-DD)

Exemples :

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

Notes

• OpenClaw utilise le forfait Brave Search. Si vous disposez d’un abonnement hérité (par exemple, le forfait Free d’origine avec 2 000 requêtes/mois), il reste valide mais n’inclut pas les nouvelles fonctionnalités telles que le contexte LLM ou des limites de débit plus élevées.
• Chaque plan Brave comprend $5/mois de crédit gratuit (renouvelable). Le plan Search coûte $5 pour 1 000 requêtes, donc le crédit couvre 1 000 requêtes par mois. Définissez votre limite d’utilisation dans le tableau de bord Brave pour éviter des frais inattendus. Consultez le portail API Brave pour les plans actuels.
• Le plan Search inclut le point de terminaison LLM Context et les droits d’inférence IA. Le stockage des résultats pour entraîner ou régler des modèles nécessite un plan avec des droits de stockage explicites. Consultez les Conditions d’utilisation de Brave.
• Les résultats sont mis en cache pendant 15 minutes par défaut (configurable via cacheTtlMinutes).

Connexes

• Aperçu de la recherche Web — tous les fournisseurs et détection automatique
• Recherche Perplexity — résultats structurés avec filtrage de domaine
• Recherche Exa — recherche neurale avec extraction de contenu