Passer au contenu principal

​
Recherche Exa

OpenClaw prend en charge Exa AI comme fournisseur web_search. Exa propose des modes de recherche neuronale, par mots-clés et hybrides avec une extraction de contenu intégrée (surlignages, texte, résumés).

​
Obtenir une clé API

1

Créer un compte

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

Stocker la clé

Définissez EXA_API_KEY dans l’environnement de la Gateway, ou configurez-la via :
openclaw configure --section web

​
Configuration

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // facultatif si EXA_API_KEY est défini
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
Alternative par environnement : définissez EXA_API_KEY dans l’environnement de la Gateway. Pour une installation de gateway, placez-la dans ~/.openclaw/.env.

​
Paramètres de l’outil

ParameterDescription
queryRequête de recherche (obligatoire)
countRésultats à renvoyer (1-100)
typeMode de recherche : auto, neural, fast, deep, deep-reasoning ou instant
freshnessFiltre temporel : day, week, month ou year
date_afterRésultats après cette date (YYYY-MM-DD)
date_beforeRésultats avant cette date (YYYY-MM-DD)
contentsOptions d’extraction de contenu (voir ci-dessous)

​
Extraction de contenu

Exa peut renvoyer du contenu extrait en plus des résultats de recherche. Passez un objet contents pour l’activer : 
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // texte complet de la page
    highlights: { numSentences: 3 }, // phrases clés
    summary: true, // résumé IA
  },
});
Contents optionTypeDescription
textboolean | { maxCharacters }Extraire le texte complet de la page
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Extraire les phrases clés
summaryboolean | { query }Résumé généré par IA

​
Modes de recherche

ModeDescription
autoExa choisit le meilleur mode (par défaut)
neuralRecherche sémantique / basée sur le sens
fastRecherche rapide par mots-clés
deepRecherche approfondie complète
deep-reasoningRecherche approfondie avec raisonnement
instantRésultats les plus rapides

​
Notes

  • Si aucune option contents n’est fournie, Exa utilise par défaut { highlights: true } afin que les résultats incluent des extraits de phrases clés
  • Les résultats conservent les champs highlightScores et summary de la réponse API Exa lorsqu’ils sont disponibles
  • Les descriptions des résultats sont résolues d’abord à partir des surlignages, puis du résumé, puis du texte complet — selon ce qui est disponible
  • freshness et date_after/date_before ne peuvent pas être combinés — utilisez un seul mode de filtrage temporel
  • Jusqu’à 100 résultats peuvent être renvoyés par requête (sous réserve des limites du type de recherche Exa)
  • Les résultats sont mis en cache pendant 15 minutes par défaut (configurable via cacheTtlMinutes)
  • Exa est une intégration officielle d’API avec des réponses JSON structurées

​
Lié