Aller au contenu
OpenClaw Docs

Recherche Brave

OpenClaw prend en charge l’API Brave Search en tant que provider OpenClawBraveAPIweb_search.

Obtenir une clé API

Section intitulée « Obtenir une clé API »
  1. Créez un compte API Brave Search sur BraveAPIhttps://brave.com/search/api/
  2. Dans le tableau de bord, choisissez le plan Search et générez une clé API.
  3. Stockez la clé dans la configuration ou définissez BRAVE_API_KEYGateway dans l’environnement de la Gateway.

Exemple de configuration

Section intitulée « Exemple de configuration »
{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

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

webSearch.modeBrave contrôle le transport Brave :

  • webBrave (par défaut) : recherche web Brave normale avec des titres, des URL et des extraits
  • llm-contextBraveLLMAPI : API de contexte LLM Brave avec des blocs de texte pré-extraits et des sources pour le grounding

webSearch.baseUrlBraveBraveOpenClaw peut diriger les requêtes Brave vers un proxy compatible Brave de confiance ou une passerelle. OpenClaw ajoute /res/v1/web/search ou /res/v1/llm/context à l’URL de base configurée et conserve l’URL de base dans la clé de cache. Les points de terminaison publics doivent utiliser https:// ; http:// n’est accepté que pour les hôtes proxy de bouclage de confiance ou de réseau privé.

Paramètres de l’outil

Section intitulée « Paramètres de l’outil »
Requête de recherche. Nombre de résultats à renvoyer (1–10). Code de pays ISO à 2 lettres (par ex. `US`, `DE`). Code de langue ISO 639-1 pour les résultats de recherche (par ex. `en`, `de`, `fr`). Code de langue de recherche Brave (p. ex. `en`, `en-gb`, `zh-hans`). Code de langue ISO pour les éléments de l'interface utilisateur. Filtre temporel — `day` correspond à 24 heures. Uniquement les résultats publiés après cette date (`YYYY-MM-DD`). 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

Section intitulée « Notes »
  • OpenClaw utilise le plan Brave Search. Si vous disposez d’un abonnement hérité (par exemple, le plan Free original avec 2 000 requêtes/mois), il reste valide mais n’inclut pas les fonctionnalités plus récentes telles que le contexte LLM ou des limites de débit plus élevées.
  • Chaque plan Brave inclut $5/mois de crédit gratuit (renouvelable). Le plan de recherche 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 Brave API pour les plans actuels.
  • Le plan de recherche inclut le point de terminaison de contexte LLM 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. Voir les Conditions d’utilisation de Brave.
  • Le mode llm-context renvoie des entrées de source ancrées au lieu de la forme normale d’extrait de recherche Web.
  • Le mode llm-context prend en charge freshness et 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 les dates de début et de fin.
  • ui_lang doit inclure une sous-balise de région comme en-US.
  • Les résultats sont mis en cache pendant 15 minutes par défaut (configurable via cacheTtlMinutes).
  • Les valeurs webSearch.baseUrlBrave personnalisées sont incluses dans l’identité du cache Brave, ce qui évite que les réponses spécifiques aux proxies ne entrent en conflit.
  • Activez l’indicateur de diagnostic brave.httpBraveAPI pour consigner les URL/paramètres de requête Brave, l’état/le timing de la réponse, ainsi que les événements de succès/échec/écriture du cache de recherche lors du troubleshooting. L’indicateur ne consigne jamais la clé API ou les corps de réponse, mais les requêtes de recherche peuvent être sensibles.

Connexes

Section intitulée « Connexes »