---
read_when:
    - Sie möchten Perplexity als Provider für die Websuche konfigurieren
    - Sie benötigen den Perplexity-API-Schlüssel oder eine OpenRouter-Proxy-Konfiguration.
summary: Einrichtung des Perplexity-Providers für die Websuche (API-Schlüssel, Suchmodi, Filterung)
title: Perplexity
x-i18n:
    generated_at: "2026-07-12T02:06:20Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: ea76a5cb7befce95756e9bcc8f9c1637fac87711d02d8a486ec2a1b9f51b73dc
    source_path: providers/perplexity-provider.md
    workflow: 16
---

Das Perplexity-Plugin registriert einen `web_search`-Provider mit zwei Transportwegen: die native Perplexity Search API (strukturierte Ergebnisse mit Filtern) und Perplexity-Sonar-Chat-Completions, direkt oder über OpenRouter (KI-generierte Antworten mit Quellenangaben).

<Note>
Diese Seite behandelt die Einrichtung des Perplexity-**Providers**. Informationen zum Perplexity-**Tool** (wie der Agent es verwendet) finden Sie unter [Perplexity-Suche](/de/tools/perplexity-search).
</Note>

| Eigenschaft      | Wert                                                                       |
| ---------------- | -------------------------------------------------------------------------- |
| Typ              | Websuch-Provider (kein Modell-Provider)                                    |
| Authentifizierung | `PERPLEXITY_API_KEY` (nativ) oder `OPENROUTER_API_KEY` (über OpenRouter)   |
| Konfigurationspfad | `plugins.entries.perplexity.config.webSearch.apiKey`                      |
| Überschreibungen | `plugins.entries.perplexity.config.webSearch.baseUrl` / `.model`           |
| Schlüssel anfordern | [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api)    |

## Plugin installieren

```bash
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart
```

## Erste Schritte

<Steps>
  <Step title="API-Schlüssel festlegen">
    ```bash
    openclaw configure --section web
    ```

    Alternativ können Sie den Schlüssel direkt festlegen:

    ```bash
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
    ```

    Ein als `PERPLEXITY_API_KEY` oder `OPENROUTER_API_KEY` in der Gateway-Umgebung
    exportierter Schlüssel funktioniert ebenfalls.

  </Step>
  <Step title="Suche starten">
    `web_search` erkennt Perplexity automatisch, sobald dessen Schlüssel als
    Suchzugangsdaten verfügbar ist. Eine weitere Einrichtung ist nicht erforderlich.
    So legen Sie den Provider ausdrücklich fest:

    ```bash
    openclaw config set tools.web.search.provider perplexity
    ```

  </Step>
</Steps>

## Suchmodi

Das Plugin bestimmt den Transportweg in dieser Reihenfolge:

1. `webSearch.baseUrl` oder `webSearch.model` ist festgelegt: Die Anfragen werden unabhängig vom Schlüsseltyp immer über Sonar-Chat-Completions an diesen Endpunkt weitergeleitet.
2. Andernfalls bestimmt die Herkunft des Schlüssels den Endpunkt: Bei einem konfigurierten Schlüssel wählt dessen Präfix den Transportweg aus (die Konfiguration hat Vorrang vor Umgebungsvariablen); ein Umgebungsschlüssel verwendet direkt den zugehörigen Endpunkt.

| Schlüsselpräfix | Transportweg                                               | Funktionen                                              |
| --------------- | ---------------------------------------------------------- | ------------------------------------------------------- |
| `pplx-`         | Native Perplexity Search API (`https://api.perplexity.ai`) | Strukturierte Ergebnisse, Domain-/Sprach-/Datumsfilter |
| `sk-or-`        | OpenRouter (`https://openrouter.ai/api/v1`), Sonar-Modell  | KI-generierte Antworten mit Quellenangaben              |

Ein konfigurierter Schlüssel mit einem anderen Präfix verwendet ebenfalls die native Search API. Der Chat-Completions-Pfad verwendet standardmäßig das Modell `perplexity/sonar-pro`; Sie können es mit `plugins.entries.perplexity.config.webSearch.model` überschreiben.

## Filterung der nativen API

| Filter                               | Beschreibung                                                            | Transportweg |
| ------------------------------------ | ----------------------------------------------------------------------- | ------------ |
| `count`                              | Ergebnisse pro Suche, 1–10 (Standardwert: 5)                            | Nur nativ    |
| `freshness`                          | Aktualitätszeitraum: `day`, `week`, `month`, `year`                     | Beide        |
| `country`                            | Zweistelliger Ländercode (`us`, `de`, `jp`)                             | Nur nativ    |
| `language`                           | Sprachcode nach ISO 639-1 (`en`, `fr`, `zh`)                            | Nur nativ    |
| `date_after` / `date_before`         | Veröffentlichungszeitraum im Format `YYYY-MM-DD`                        | Nur nativ    |
| `domain_filter`                      | Maximal 20 Domains; Positivliste oder mit `-` präfigierte Negativliste, niemals gemischt | Nur nativ |
| `max_tokens` / `max_tokens_per_page` | Inhaltsbudget für alle Ergebnisse / pro Seite                           | Nur nativ    |

Filter, die nur für den nativen Transportweg verfügbar sind, geben im Chat-Completions-Pfad eine aussagekräftige Fehlermeldung zurück. `freshness` kann nicht mit `date_after`/`date_before` kombiniert werden.

## Erweiterte Konfiguration

<AccordionGroup>
  <Accordion title="Umgebungsvariable für Daemon-Prozesse">
    <Warning>
    Ein Schlüssel, der nur in einer interaktiven Shell exportiert wurde, ist für
    einen als launchd-/systemd-Daemon ausgeführten Gateway nicht sichtbar, sofern
    diese Umgebung nicht ausdrücklich importiert wird. Legen Sie den Schlüssel in
    `~/.openclaw/.env` oder über `env.shellEnv` fest, damit der Gateway-Prozess
    darauf zugreifen kann. Die vollständige Rangfolge finden Sie unter
    [Umgebungsvariablen](/de/help/environment).
    </Warning>
  </Accordion>

  <Accordion title="OpenRouter-Proxy einrichten">
    Um Perplexity-Suchen über OpenRouter weiterzuleiten, legen Sie anstelle eines
    nativen Perplexity-Schlüssels einen `OPENROUTER_API_KEY` (Präfix `sk-or-`) fest.
    OpenClaw erkennt den Schlüssel und wechselt automatisch zum Sonar-Transportweg.
    Dies ist nützlich, wenn Sie die Abrechnung über OpenRouter bereits eingerichtet
    haben und Ihre Provider dort zusammenführen möchten.
  </Accordion>
</AccordionGroup>

## Verwandte Themen

<CardGroup cols={2}>
  <Card title="Perplexity-Suchtool" href="/de/tools/perplexity-search" icon="magnifying-glass">
    Wie der Agent Perplexity-Suchen aufruft und die Ergebnisse interpretiert.
  </Card>
  <Card title="Konfigurationsreferenz" href="/de/gateway/configuration-reference" icon="gear">
    Vollständige Konfigurationsreferenz einschließlich Plugin-Einträgen.
  </Card>
</CardGroup>