Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Obtenir une clé d’API

1

Créer un compte

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

Stocker la clé

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

Configuration

{
  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",
      },
    },
  },
}
Autre option d’environnement : définissez EXA_API_KEY dans l’environnement Gateway. Pour une installation Gateway, placez-la dans ~/.openclaw/.env.

Remplacement de l’URL de base

Définissez plugins.entries.exa.config.webSearch.baseUrl 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 ajoute /search, sauf si le chemin se termine déjà ainsi. Le point de terminaison résolu est inclus dans la clé du cache de recherche, afin que les résultats provenant de différents points de terminaison Exa ne soient pas partagés.

Paramètres de l’outil

query
string
requis
Requête de recherche.
count
number
Résultats à renvoyer (1–100).
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Mode de recherche.
freshness
'day' | 'week' | 'month' | 'year'
Filtre temporel.
date_after
string
Résultats après cette date (YYYY-MM-DD).
date_before
string
Résultats avant cette date (YYYY-MM-DD).
contents
object
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 l’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 de contenuTypeDescription
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 l’IA

Modes de recherche

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

Remarques

  • 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 de l’API Exa lorsqu’ils sont disponibles
  • Les descriptions des résultats sont résolues à partir des extraits d’abord, 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 d’API officielle avec des réponses JSON structurées

Articles connexes