Skip to main content
Le plugin Perplexity enregistre un fournisseur web_search avec deux modes de transport : l’API Perplexity Search native (résultats structurés avec filtres) et les complétions de chat Perplexity Sonar, directement ou via OpenRouter (réponses synthétisées par l’IA avec citations).
Cette page décrit la configuration du fournisseur Perplexity. Pour l’outil Perplexity (la manière dont l’agent l’utilise), consultez Recherche Perplexity.

​
Installer le Plugin

​
Prise en main

1

Définir la clé d’API

Vous pouvez également définir directement la clé :
Une clé exportée sous la forme PERPLEXITY_API_KEY ou OPENROUTER_API_KEY dans l’environnement du Gateway fonctionne également.
2

Commencer les recherches

web_search détecte automatiquement Perplexity dès que sa clé constitue l’identifiant de recherche disponible ; aucune configuration supplémentaire n’est requise. Pour sélectionner explicitement le fournisseur :

​
Modes de recherche

Le Plugin détermine le mode de transport dans l’ordre suivant :
  1. Si webSearch.baseUrl ou webSearch.model est défini, les requêtes sont toujours acheminées vers les complétions de chat Sonar sur ce point de terminaison, quel que soit le type de clé.
  2. Sinon, la source de la clé détermine le point de terminaison : le préfixe d’une clé configurée sélectionne le mode de transport (la configuration prévaut sur les variables d’environnement) ; une clé d’environnement utilise directement le point de terminaison correspondant.
Une clé configurée avec tout autre préfixe utilise également l’API Search native. Le chemin des complétions de chat utilise par défaut le modèle perplexity/sonar-pro ; remplacez-le avec plugins.entries.perplexity.config.webSearch.model.

​
Filtrage de l’API native

Les filtres réservés à l’API native renvoient une erreur descriptive avec le chemin des complétions de chat. freshness ne peut pas être combiné avec date_after/date_before.

​
Configuration avancée

Une clé exportée uniquement dans un shell interactif n’est pas visible par un démon Gateway launchd/systemd, sauf si cet environnement est explicitement importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv afin que le processus Gateway puisse la lire. Consultez Variables d’environnement pour connaître l’ordre de priorité complet.
Pour 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étecte la clé et passe automatiquement au mode de transport Sonar. Cette option est utile si vous avez déjà configuré la facturation OpenRouter et souhaitez y regrouper les fournisseurs.

​
Pages connexes

Outil de recherche Perplexity

Manière dont l’agent lance les recherches Perplexity et interprète les résultats.

Référence de configuration

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