Zum Hauptinhalt springen
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.
EigenschaftWert
TypWebsuch-Provider (kein Modell-Provider)
AuthPERPLEXITY_API_KEY (direkt) oder OPENROUTER_API_KEY (über OpenRouter)
Konfigurationspfadplugins.entries.perplexity.config.webSearch.apiKey

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend den Gateway neu: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Erste Schritte

1

API-Schlüssel festlegen

Führen Sie den interaktiven Konfigurationsablauf für die Websuche 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

Suche starten

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).
SchlüsselpräfixTransportFunktionen
pplx-Native Perplexity Search APIStrukturierte Ergebnisse, Domain-/Sprach-/Datumsfilter
sk-or-OpenRouter (Sonar)KI-generierte Antworten mit Zitierungen

​
Filterung mit der nativen API

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:
FilterBeschreibungBeispiel
Land2-Buchstaben-Ländercodeus, de, jp
SpracheISO-639-1-Sprachcodeen, fr, zh
DatumsbereichAktualitätsfensterday, week, month, year
DomainfilterAllowlist oder Denylist (max. 20 Domains)example.com
InhaltsbudgetToken-Limits pro Antwort / pro Seitemax_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.
Ein Schlüssel, der nur in einer interaktiven Shell exportiert wurde, ist für einen launchd/systemd-Daemon 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 ihn lesen kann.
Wenn Sie Perplexity-Suchen lieber über OpenRouter weiterleiten möchten, legen Sie OPENROUTER_API_KEY (Präfix sk-or-) anstelle eines nativen Perplexity-Schlüssels fest. 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.