Skip to main content
Das Perplexity-Plugin registriert einen web_search-Provider mit zwei Transportwegen: der nativen Perplexity Search API (strukturierte Ergebnisse mit Filtern) und Perplexity Sonar Chat Completions, direkt oder über OpenRouter (KI-generierte Antworten mit Quellenangaben).
Diese Seite behandelt die Einrichtung des Perplexity-Providers. Informationen zum Perplexity-Tool (wie der Agent es verwendet) finden Sie unter Perplexity-Suche.

​
Plugin installieren

​
Erste Schritte

1

API-Schlüssel festlegen

Alternativ können Sie den Schlüssel direkt festlegen:
Ein als PERPLEXITY_API_KEY oder OPENROUTER_API_KEY in der Gateway- Umgebung exportierter Schlüssel funktioniert ebenfalls.
2

Suche starten

web_search erkennt Perplexity automatisch, sobald dessen Schlüssel als Suchzugangsdaten verfügbar ist; keine weitere Einrichtung ist erforderlich. So legen Sie den Provider ausdrücklich fest:

​
Suchmodi

Das Plugin bestimmt den Transportweg in dieser Reihenfolge:
  1. webSearch.baseUrl oder webSearch.model festgelegt: Die Weiterleitung erfolgt unabhängig vom Schlüsseltyp immer über Sonar Chat Completions an diesen Endpunkt.
  2. Andernfalls bestimmt die Quelle des Schlüssels den Endpunkt: Das Präfix eines konfigurierten Schlüssels legt den Transportweg fest (die Konfiguration hat Vorrang vor Umgebungsvariablen); ein Umgebungsschlüssel verwendet direkt den zugehörigen Endpunkt.
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, die nur nativ unterstützt werden, geben im Chat-Completions-Pfad einen aussagekräftigen Fehler zurück. freshness kann nicht mit date_after/date_before kombiniert werden.

​
Erweiterte Konfiguration

Ein nur in einer interaktiven Shell exportierter Schlüssel 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.
Um Perplexity-Suchen über OpenRouter weiterzuleiten, legen Sie einen OPENROUTER_API_KEY (Präfix sk-or-) anstelle eines nativen Perplexity-Schlüssels fest. OpenClaw erkennt den Schlüssel und wechselt automatisch zum Sonar-Transportweg. Dies ist nützlich, wenn Sie bereits die Abrechnung über OpenRouter eingerichtet haben und Provider dort konsolidieren möchten.

​
Verwandte Themen

Perplexity-Suchtool

Wie der Agent Perplexity-Suchen aufruft und Ergebnisse interpretiert.

Konfigurationsreferenz

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