| read_when |
summary |
title |
x-i18n |
| Sie möchten Perplexity als Provider für die Websuche konfigurieren |
| Sie benötigen den Perplexity-API-Schlüssel oder eine OpenRouter-Proxy-Konfiguration. |
|
Einrichtung des Perplexity-Providers für die Websuche (API-Schlüssel, Suchmodi, Filterung) |
Perplexity |
| generated_at |
model |
provider |
source_hash |
source_path |
workflow |
| 2026-04-30T07:11:33Z |
gpt-5.5 |
openai |
36475ba0d6ab7d569f83b7f6fdc13c5dbe6b12ca5acab44e8d213da23d04a795 |
providers/perplexity-provider.md |
16 |
|
Das Perplexity-Plugin stellt Websuchfunktionen über die Perplexity
Search API oder Perplexity Sonar über OpenRouter bereit.
Diese Seite beschreibt die Einrichtung des Perplexity-**Providers**. Für das Perplexity-**Tool** (wie der Agent es verwendet), siehe [Perplexity-Tool](/de/tools/perplexity-search).
| Eigenschaft |
Wert |
| Typ |
Websuch-Provider (kein Modell-Provider) |
| Auth |
PERPLEXITY_API_KEY (direkt) oder OPENROUTER_API_KEY (über OpenRouter) |
| Konfigurationspfad |
plugins.entries.perplexity.config.webSearch.apiKey |
Erste Schritte
Führen Sie den interaktiven Konfigurationsablauf für die Websuche aus:
```bash
openclaw configure --section web
```
Oder legen Sie den Schlüssel direkt fest:
```bash
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
```
Der Agent verwendet Perplexity automatisch für Websuchen, sobald der Schlüssel
konfiguriert ist. Es sind keine weiteren Schritte erforderlich.
Suchmodi
Das Plugin wählt den Transport automatisch anhand des API-Schlüsselpräfixes aus:
Wenn Ihr Schlüssel mit `pplx-` beginnt, verwendet OpenClaw die native Perplexity Search
API. Dieser Transport gibt strukturierte Ergebnisse zurück und unterstützt Domain-,
Sprach- und Datumsfilter (siehe Filteroptionen unten).
Wenn Ihr Schlüssel mit `sk-or-` beginnt, leitet OpenClaw über OpenRouter weiter und verwendet
das Perplexity Sonar-Modell. Dieser Transport gibt KI-synthetisierte Antworten mit
Zitierungen zurück.
| Schlüsselpräfix |
Transport |
Funktionen |
pplx- |
Native Perplexity Search API |
Strukturierte Ergebnisse, Domain-/Sprach-/Datumsfilter |
sk-or- |
OpenRouter (Sonar) |
KI-synthetisierte Antworten mit Zitierungen |
Native API-Filterung
Filteroptionen sind nur verfügbar, wenn die native Perplexity API
(`pplx-`-Schlüssel) verwendet wird. OpenRouter/Sonar-Suchen unterstützen diese Parameter nicht.
Bei Verwendung der nativen Perplexity API unterstützen Suchen die folgenden Filter:
| Filter |
Beschreibung |
Beispiel |
| Land |
2-stelliger Ländercode |
us, de, jp |
| Sprache |
ISO-639-1-Sprachcode |
en, fr, zh |
| Datumsbereich |
Aktualitätsfenster |
day, week, month, year |
| Domain-Filter |
Allowlist oder Denylist (max. 20 Domains) |
example.com |
| Inhaltsbudget |
Token-Limits pro Antwort / pro Seite |
max_tokens, max_tokens_per_page |
Erweiterte Konfiguration
Wenn der OpenClaw Gateway als Daemon (launchd/systemd) läuft, stellen Sie sicher,
dass `PERPLEXITY_API_KEY` für diesen Prozess verfügbar ist.
<Warning>
Ein Schlüssel, der nur in `~/.profile` gesetzt ist, ist für einen launchd/systemd-
Daemon nicht sichtbar, sofern diese Umgebung nicht explizit importiert wird. Setzen Sie den Schlüssel in
`~/.openclaw/.env` oder über `env.shellEnv`, um sicherzustellen, dass der Gateway-Prozess ihn
lesen kann.
</Warning>
Wenn Sie Perplexity-Suchen lieber über OpenRouter leiten möchten, legen Sie statt eines nativen Perplexity-Schlüssels einen
`OPENROUTER_API_KEY` (Präfix `sk-or-`) fest.
OpenClaw erkennt das Präfix und wechselt automatisch zum Sonar-Transport.
<Tip>
Der OpenRouter-Transport ist nützlich, wenn Sie bereits ein OpenRouter-Konto haben
und eine konsolidierte Abrechnung über mehrere Provider wünschen.
</Tip>
Verwandte Themen
Wie der Agent Perplexity-Suchen aufruft und Ergebnisse interpretiert.
Vollständige Konfigurationsreferenz einschließlich Plugin-Einträgen.
