Tools

Recherche Exa

Exa AI est un fournisseur de web_search proposant des modes de recherche neuronale, par mots-clés et hybride, ainsi qu’une extraction de contenu intégrée (passages clés, texte, résumés).

Installer le Plugin

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

Obtenir une clé d’API

Créer un compte

Inscrivez-vous sur exa.ai et générez une clé d’API depuis votre tableau de bord.

Stocker la clé

Définissez EXA_API_KEY dans l’environnement du Gateway, ou configurez-la via :

bash

openclaw configure --section web

Configuration

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // facultatif si EXA_API_KEY est défini            baseUrl: "https://api.exa.ai", // facultatif ; OpenClaw ajoute /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

Autre possibilité avec une variable d’environnement : définissez EXA_API_KEY dans l’environnement du Gateway. Pour une installation du Gateway, placez-la dans ~/.openclaw/.env. Consultez Variables d’environnement.

Remplacement de l’URL de base

Définissez plugins.entries.exa.config.webSearch.baseUrl pour acheminer les requêtes de recherche Exa via un proxy compatible ou un autre point de terminaison. OpenClaw normalise les hôtes sans protocole en ajoutant https:// au début et ajoute /search, sauf si le chemin se termine déjà ainsi. Le point de terminaison résolu fait partie de la clé du cache de recherche ; les résultats provenant de points de terminaison différents ne sont donc jamais partagés.

Paramètres de l’outil

querystringrequired

Requête de recherche.

countnumberdefault: 5

Nombre de résultats à renvoyer (1 à 100, dans les limites du type de recherche Exa).

Mode de recherche.

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

Filtre temporel. Ne peut pas être combiné avec date_after/date_before.

date_afterstring

Résultats postérieurs à cette date (YYYY-MM-DD).

date_beforestring

Résultats antérieurs à cette date (YYYY-MM-DD).

contentsobject

Options d’extraction du contenu (voir ci-dessous).

Extraction du contenu

Transmettez un objet contents pour contrôler le contenu extrait dans les résultats :

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // texte intégral de la page    highlights: { numSentences: 3 }, // phrases clés    summary: true, // résumé généré par l’IA  },});

Option de contenu	Type	Description
`text`	`boolean \| { maxCharacters }`	Extraire le texte intégral de la page
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Extraire les phrases clés
`summary`	`boolean \| { query }`	Résumé généré par l’IA

Si contents est omis, Exa utilise par défaut { highlights: true } afin que les résultats incluent des extraits de phrases clés. Les descriptions des résultats sont obtenues d’abord à partir des passages clés, puis du résumé, puis du texte intégral, selon le premier élément disponible. Les résultats conservent également les champs bruts highlightScores et summary de la réponse de l’API Exa lorsqu’ils sont disponibles.

Modes de recherche

Mode	Description
`auto`	Exa choisit le meilleur mode (par défaut)
`neural`	Recherche sémantique fondée sur le sens
`fast`	Recherche rapide par mots-clés
`deep`	Recherche approfondie et exhaustive
`deep-reasoning`	Recherche approfondie avec raisonnement
`instant`	Résultats les plus rapides

Remarques

count accepte jusqu’à 100, dans les limites du type de recherche Exa.
Les résultats sont mis en cache pendant 15 minutes par défaut. Configurez les paramètres partagés tools.web.search.cacheTtlMinutes (en minutes) et tools.web.search.timeoutSeconds (30 s par défaut) pour modifier la mise en cache et le délai d’expiration des requêtes pour tous les fournisseurs de web_search, y compris Exa.

Voir aussi

Présentation de la recherche Web -- tous les fournisseurs et la détection automatique
Brave Search -- résultats structurés avec filtres par pays et par langue
Perplexity Search -- résultats structurés avec filtrage par domaine

Was this useful?