Passer au contenu principal
Le Plugin Perplexity fournit des capacités de recherche web via l’API Perplexity Search ou Perplexity Sonar via OpenRouter.
Cette page concerne la configuration du fournisseur Perplexity. Pour l’outil Perplexity (la façon dont l’agent l’utilise), consultez l’outil Perplexity.
PropriétéValeur
TypeFournisseur de recherche web (pas un fournisseur de modèle)
AuthentificationPERPLEXITY_API_KEY (direct) ou OPENROUTER_API_KEY (via OpenRouter)
Chemin de configurationplugins.entries.perplexity.config.webSearch.apiKey

​
Installer le Plugin

Installez le Plugin officiel, puis redémarrez Gateway : 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Premiers pas

1

Set the API key

Exécutez le flux interactif de configuration de la recherche web :
openclaw configure --section web
Ou définissez la clé directement :
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Start searching

L’agent utilisera automatiquement Perplexity pour les recherches web une fois la clé configurée. Aucune étape supplémentaire n’est requise.

​
Modes de recherche

Le Plugin sélectionne automatiquement le transport selon le préfixe de la clé API :
Lorsque votre clé commence par pplx-, OpenClaw utilise l’API native Perplexity Search. Ce transport renvoie des résultats structurés et prend en charge les filtres de domaine, de langue et de date (voir les options de filtrage ci-dessous).
Préfixe de cléTransportFonctionnalités
pplx-API native Perplexity SearchRésultats structurés, filtres de domaine/langue/date
sk-or-OpenRouter (Sonar)Réponses synthétisées par IA avec citations

​
Filtrage de l’API native

Les options de filtrage ne sont disponibles que lors de l’utilisation de l’API native Perplexity (clé pplx-). Les recherches OpenRouter/Sonar ne prennent pas en charge ces paramètres.
Lors de l’utilisation de l’API native Perplexity, les recherches prennent en charge les filtres suivants :
FiltreDescriptionExemple
PaysCode pays à 2 lettresus, de, jp
LangueCode de langue ISO 639-1en, fr, zh
Plage de datesFenêtre de récenceday, week, month, year
Filtres de domaineListe d’autorisation ou de refus (20 domaines max.)example.com
Budget de contenuLimites de tokens par réponse / par pagemax_tokens, max_tokens_per_page

​
Configuration avancée

Si OpenClaw Gateway s’exécute en tant que daemon (launchd/systemd), assurez-vous que PERPLEXITY_API_KEY est disponible pour ce processus.
Une clé exportée uniquement dans un shell interactif ne sera pas visible par un daemon launchd/systemd, sauf si cet environnement est explicitement importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv pour garantir que le processus Gateway peut la lire.
Si vous préférez acheminer les recherches Perplexity via OpenRouter, définissez une OPENROUTER_API_KEY (préfixe sk-or-) au lieu d’une clé Perplexity native. OpenClaw détectera le préfixe et basculera automatiquement vers le transport Sonar.
Le transport OpenRouter est utile si vous disposez déjà d’un compte OpenRouter et souhaitez une facturation consolidée entre plusieurs fournisseurs.

​
Connexe

Perplexity search tool

Comment l’agent invoque les recherches Perplexity et interprète les résultats.

Configuration reference

Référence de configuration complète, y compris les entrées de Plugin.