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.

Le Plugin Perplexity fournit des fonctionnalité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 (comment l’agent l’utilise), consultez outil Perplexity.
PropriétéValeur
TypeFournisseur de recherche web (pas un fournisseur de modèles)
AuthPERPLEXITY_API_KEY (direct) ou OPENROUTER_API_KEY (via OpenRouter)
Chemin de configurationplugins.entries.perplexity.config.webSearch.apiKey

​
Bien démarrer

1

Définir la clé API

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

Commencer la recherche

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 Perplexity Search native. 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 Perplexity Search nativeRé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 sont uniquement disponibles lors de l’utilisation de l’API Perplexity native (clé pplx-). Les recherches OpenRouter/Sonar ne prennent pas en charge ces paramètres.
Lors de l’utilisation de l’API Perplexity native, 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 jetons par réponse / par pagemax_tokens, max_tokens_per_page

​
Configuration avancée

Si le Gateway OpenClaw s’exécute comme daemon (launchd/systemd), assurez-vous que PERPLEXITY_API_KEY est disponible pour ce processus.
Une clé définie uniquement dans ~/.profile 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 afin que le processus Gateway puisse 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.

​
Associé

Outil de recherche Perplexity

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

Référence de configuration

Référence de configuration complète incluant les entrées de Plugin.