Recherche Exa

OpenClaw prend en charge Exa AI en tant que fournisseur web_search. Exa propose des modes de recherche neurale, par mots-clés et hybride 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 à partir de votre tableau de bord.

2. Stocker la clé

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

   openclaw configure --section web

Config

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // optional if EXA_API_KEY is set
            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}

Alternative d’environnement : définissez EXA_API_KEY dans l’environnement du Gateway. Pour une installation de passerelle, placez-la dans ~/.openclaw/.env.

Remplacement de l’URL de base

Définissez plugins.entries.exa.config.webSearch.baseUrlOpenClaw lorsque les requêtes de recherche Exa doivent passer par un proxy compatible ou un autre point de terminaison Exa. OpenClaw normalise les hôtes nus en ajoutant https:// au début et en ajoutant /search à la fin, sauf si le chemin se termine déjà là. Le point de terminaison résolu est inclus dans la clé du cache de recherche, de sorte que les résultats de différents points de terminaison Exa ne sont pas partagés.

Paramètres de l’outil

Requête de recherche. Résultats à renvoyer (1–100). Mode de recherche. Filtre de temps. Résultats après cette date (`YYYY-MM-DD`). Résultats avant cette date (`YYYY-MM-DD`). Options d'extraction de contenu (voir ci-dessous).

Extraction de contenu

Exa peut renvoyer du contenu extrait avec les résultats de recherche. Passez un objet contents pour activer :

await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});

Option Contenus	Type	Description
text	boolean | { maxCharacters }	Extraire le texte complet 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

Modes de recherche

Mode	Description
auto	Exa choisit le meilleur mode (par défaut)
neural	Recherche sémantique basée sur le sens
fast	Recherche par mots-clés rapide
deep	Recherche approfondie exhaustive
deep-reasoning	Recherche approfondie avec raisonnement
instant	Ré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 préservent les champs highlightScores et summary de la réponse de l’API Exa lorsqu’ils sont disponibles
• Les descriptions des résultats sont résolues d’abord à partir des highlights, 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 filtre temporel
• Jusqu’à 100 résultats peuvent être renvoyés par requête (sous réserve des limites de 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 de l’API avec des réponses JSON structurées

Connexes

• Aperçu de la recherche Web — tous les fournisseurs et détection automatique
• Recherche Brave — résultats structurés avec filtres de pays/langue
• Recherche Perplexity — résultats structurés avec filtrage de domaine