Zum Hauptinhalt springen

​
Perplexity (Web-Such-Provider)

Das Perplexity-Plugin stellt Web-Suchfunktionen über die Perplexity Search API oder Perplexity Sonar über OpenRouter bereit.
Diese Seite behandelt die Einrichtung des Providers Perplexity. Informationen zum Perplexity- Tool (wie der Agent es verwendet) finden Sie unter Perplexity tool.
EigenschaftWert
TypWeb-Such-Provider (kein Modell-Provider)
AuthPERPLEXITY_API_KEY (direkt) oder OPENROUTER_API_KEY (über OpenRouter)
Konfigurationspfadplugins.entries.perplexity.config.webSearch.apiKey

​
Erste Schritte

1

API-Schlüssel festlegen

Führen Sie den interaktiven Konfigurationsablauf für die Web-Suche aus:
openclaw configure --section web
Oder legen Sie den Schlüssel direkt fest:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Mit der Suche beginnen

Der Agent verwendet Perplexity automatisch für Web-Suchen, sobald der Schlüssel konfiguriert ist. Es sind keine zusätzlichen Schritte erforderlich.

​
Suchmodi

Das Plugin wählt den Transport automatisch anhand des Präfixes des API-Schlüssels 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).
SchlüsselpräfixTransportFunktionen
pplx-Native Perplexity Search APIStrukturierte Ergebnisse, Domain-/Sprach-/Datumsfilter
sk-or-OpenRouter (Sonar)KI-synthetisierte Antworten mit Zitaten

​
Filterung der nativen API

Filteroptionen sind nur verfügbar, wenn die native Perplexity API (Schlüssel pplx-) verwendet wird. OpenRouter-/Sonar-Suchen unterstützen diese Parameter nicht.
Bei Verwendung der nativen Perplexity API unterstützen Suchanfragen die folgenden Filter:
FilterBeschreibungBeispiel
Land2-stelliger Ländercodeus, de, jp
SpracheSprachcode nach ISO 639-1en, fr, zh
DatumsbereichAktualitätsfensterday, week, month, year
Domain-FilterAllowlist oder Denylist (max. 20 Domains)example.com
InhaltsbudgetToken-Limits pro Antwort / pro Seitemax_tokens, max_tokens_per_page

​
Erweiterte Hinweise

Wenn das OpenClaw Gateway als Daemon (launchd/systemd) läuft, stellen Sie sicher, dass PERPLEXITY_API_KEY für diesen Prozess verfügbar ist.
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. Legen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv fest, damit der Gateway-Prozess ihn lesen kann.
Wenn Sie Perplexity-Suchen lieber über OpenRouter leiten möchten, setzen Sie statt eines nativen Perplexity-Schlüssels einen OPENROUTER_API_KEY (Präfix sk-or-). OpenClaw erkennt das Präfix und wechselt automatisch zum Sonar-Transport.
Der OpenRouter-Transport ist nützlich, wenn Sie bereits ein OpenRouter-Konto haben und eine konsolidierte Abrechnung über mehrere Provider hinweg wünschen.

​
Verwandt

Perplexity-Suchtool

Wie der Agent Perplexity-Suchen aufruft und Ergebnisse interpretiert.

Konfigurationsreferenz

Vollständige Konfigurationsreferenz einschließlich Plugin-Einträgen.