Passer au contenu principal

Perplexity (provider de recherche web)

Le plugin Perplexity fournit des capacités de recherche web via l’API Perplexity Search ou Perplexity Sonar via OpenRouter.
Cette page couvre la configuration du provider Perplexity. Pour l’outil Perplexity (comment l’agent l’utilise), voir Perplexity tool.
  • Type : provider de recherche web (pas un provider de modèles)
  • Authentification : PERPLEXITY_API_KEY (direct) ou OPENROUTER_API_KEY (via OpenRouter)
  • Chemin de configuration : plugins.entries.perplexity.config.webSearch.apiKey

Démarrage rapide

  1. Définissez la clé API :
openclaw configure --section web
Ou définissez-la directement :
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
  1. L’agent utilisera automatiquement Perplexity pour les recherches web lorsqu’il est configuré.

Modes de recherche

Le plugin sélectionne automatiquement le transport selon le préfixe de la clé API :
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

Lors de l’utilisation de l’API Perplexity native (clé pplx-), les recherches prennent en charge :
  • Pays : code pays à 2 lettres
  • Langue : code langue ISO 639-1
  • Plage de dates : jour, semaine, mois, année
  • Filtres de domaine : liste d’autorisation/liste de refus (20 domaines max)
  • Budget de contenu : max_tokens, max_tokens_per_page

Remarque sur l’environnement

Si la Gateway s’exécute comme démon (launchd/systemd), assurez-vous que PERPLEXITY_API_KEY est disponible pour ce processus (par exemple dans ~/.openclaw/.env ou via env.shellEnv).