Providers
Perplexity
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).
| 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 abrufen | perplexity.ai/settings/api |
Plugin installieren
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartErste Schritte
API-Schlüssel festlegen
openclaw configure --section webAlternativ können Sie den Schlüssel direkt festlegen:
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.
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:
openclaw config set tools.web.search.provider perplexitySuchmodi
Das Plugin bestimmt den Transportweg in dieser Reihenfolge:
webSearch.baseUrloderwebSearch.modelfestgelegt: Die Weiterleitung erfolgt unabhängig vom Schlüsseltyp immer über Sonar Chat Completions an diesen Endpunkt.- 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.
| 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 |
ISO-639-1-Sprachcode (en, fr, zh) |
Nur nativ |
date_after / date_before |
Veröffentlichungszeitraum im Format YYYY-MM-DD |
Nur nativ |
domain_filter |
Maximal 20 Domains; Zulassungsliste oder mit - präfixierte Sperrliste, niemals gemischt |
Nur nativ |
max_tokens / max_tokens_per_page |
Inhaltsbudget für alle Ergebnisse / pro Seite | Nur nativ |
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
Umgebungsvariable für Daemon-Prozesse
OpenRouter-Proxy einrichten
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.
