Providers
Perplexity
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).
| Propriété | Valeur |
|---|---|
| Type | Fournisseur de recherche Web (et non fournisseur de modèles) |
| Authentification | PERPLEXITY_API_KEY (native) ou OPENROUTER_API_KEY (via OpenRouter) |
| Chemin de configuration | plugins.entries.perplexity.config.webSearch.apiKey |
| Remplacements | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| Obtenir une clé | perplexity.ai/settings/api |
Installer le Plugin
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartPrise en main
Définir la clé d’API
openclaw configure --section webVous pouvez également définir directement la clé :
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Une clé exportée sous la forme PERPLEXITY_API_KEY ou OPENROUTER_API_KEY dans l’environnement du Gateway fonctionne également.
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 :
openclaw config set tools.web.search.provider perplexityModes de recherche
Le Plugin détermine le mode de transport dans l’ordre suivant :
- Si
webSearch.baseUrlouwebSearch.modelest 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é. - 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.
| Préfixe de clé | Mode de transport | Fonctionnalités |
|---|---|---|
pplx- |
API Perplexity Search native (https://api.perplexity.ai) |
Résultats structurés, filtres par domaine, langue et date |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1), modèle Sonar |
Réponses synthétisées par l’IA avec citations |
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
| Filtre | Description | Mode de transport |
|---|---|---|
count |
Nombre de résultats par recherche, de 1 à 10 (5 par défaut) | API native uniquement |
freshness |
Période de récence : day, week, month, year |
Les deux |
country |
Code pays à 2 lettres (us, de, jp) |
API native uniquement |
language |
Code de langue ISO 639-1 (en, fr, zh) |
API native uniquement |
date_after / date_before |
Plage de dates de publication au format YYYY-MM-DD |
API native uniquement |
domain_filter |
20 domaines au maximum ; liste d’autorisation ou liste d’exclusion préfixée par -, jamais les deux |
API native uniquement |
max_tokens / max_tokens_per_page |
Budget de contenu pour l’ensemble des résultats / par page | API native uniquement |
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
Variable d’environnement pour les processus démons
Configuration du proxy OpenRouter
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.
