> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Perplexity

Le Plugin Perplexity fournit des capacités de recherche web via l’API Perplexity
Search ou Perplexity Sonar via OpenRouter.

<Note>
  Cette page concerne la configuration du **fournisseur** Perplexity. Pour l’**outil** Perplexity (la façon dont l’agent l’utilise), consultez [l’outil Perplexity](/fr/tools/perplexity-search).
</Note>

| Propriété               | Valeur                                                                 |
| ----------------------- | ---------------------------------------------------------------------- |
| Type                    | Fournisseur de recherche web (pas un fournisseur de modèle)            |
| Authentification        | `PERPLEXITY_API_KEY` (direct) ou `OPENROUTER_API_KEY` (via OpenRouter) |
| Chemin de configuration | `plugins.entries.perplexity.config.webSearch.apiKey`                   |

## Installer le Plugin

Installez le Plugin officiel, puis redémarrez Gateway :

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart
```

## Premiers pas

<Steps>
  <Step title="Set the API key">
    Exécutez le flux interactif de configuration de la recherche web :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```

    Ou définissez la clé directement :

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
    ```
  </Step>

  <Step title="Start searching">
    L’agent utilisera automatiquement Perplexity pour les recherches web une fois la clé
    configurée. Aucune étape supplémentaire n’est requise.
  </Step>
</Steps>

## Modes de recherche

Le Plugin sélectionne automatiquement le transport selon le préfixe de la clé API :

<Tabs>
  <Tab title="Native Perplexity API (pplx-)">
    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).
  </Tab>

  <Tab title="OpenRouter / Sonar (sk-or-)">
    Lorsque votre clé commence par `sk-or-`, OpenClaw passe par OpenRouter en utilisant
    le modèle Perplexity Sonar. Ce transport renvoie des réponses synthétisées par IA avec
    citations.
  </Tab>
</Tabs>

| Préfixe de clé | Transport                    | Fonctionnalités                                      |
| -------------- | ---------------------------- | ---------------------------------------------------- |
| `pplx-`        | API native Perplexity Search | Ré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

<Note>
  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.
</Note>

Lors de l’utilisation de l’API native Perplexity, les recherches prennent en charge les filtres suivants :

| Filtre             | Description                                         | Exemple                             |
| ------------------ | --------------------------------------------------- | ----------------------------------- |
| Pays               | Code pays à 2 lettres                               | `us`, `de`, `jp`                    |
| Langue             | Code de langue ISO 639-1                            | `en`, `fr`, `zh`                    |
| Plage de dates     | Fenêtre de récence                                  | `day`, `week`, `month`, `year`      |
| Filtres de domaine | Liste d’autorisation ou de refus (20 domaines max.) | `example.com`                       |
| Budget de contenu  | Limites de tokens par réponse / par page            | `max_tokens`, `max_tokens_per_page` |

## Configuration avancée

<AccordionGroup>
  <Accordion title="Environment variable for daemon processes">
    Si OpenClaw Gateway s’exécute en tant que daemon (launchd/systemd), assurez-vous que
    `PERPLEXITY_API_KEY` est disponible pour ce processus.

    <Warning>
      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.
    </Warning>
  </Accordion>

  <Accordion title="OpenRouter proxy setup">
    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.

    <Tip>
      Le transport OpenRouter est utile si vous disposez déjà d’un compte OpenRouter
      et souhaitez une facturation consolidée entre plusieurs fournisseurs.
    </Tip>
  </Accordion>
</AccordionGroup>

## Connexe

<CardGroup cols={2}>
  <Card title="Perplexity search tool" href="/fr/tools/perplexity-search" icon="magnifying-glass">
    Comment l’agent invoque les recherches Perplexity et interprète les résultats.
  </Card>

  <Card title="Configuration reference" href="/fr/gateway/configuration-reference" icon="gear">
    Référence de configuration complète, y compris les entrées de Plugin.
  </Card>
</CardGroup>