English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

Recherche Exa

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

  • 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 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

    querystringrequired

    Requête de recherche.

    countnumber

    Résultats à renvoyer (1–100).

    type'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'

    Mode de recherche.

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

    Filtre temporel.

    date_afterstring

    Résultats après cette date (YYYY-MM-DD).

    date_beforestring

    Résultats avant cette date (YYYY-MM-DD).

    contentsobject

    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 contenu 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/fondée sur le sens
    fast Recherche rapide par mots-clés
    deep Recherche approfondie complète
    deep-reasoning Recherche approfondie avec raisonnement
    instant Ré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