Providers
Perplexity
Das Perplexity-Plugin registriert einen web_search-Provider mit zwei Transportwegen: die native 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 anfordern | 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. Eine weitere Einrichtung ist nicht 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.modelist festgelegt: Die Anfragen werden unabhängig vom Schlüsseltyp immer über Sonar-Chat-Completions an diesen Endpunkt weitergeleitet.- Andernfalls bestimmt die Herkunft des Schlüssels den Endpunkt: Bei einem konfigurierten Schlüssel wählt dessen Präfix den Transportweg aus (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 |
Sprachcode nach ISO 639-1 (en, fr, zh) |
Nur nativ |
date_after / date_before |
Veröffentlichungszeitraum im Format YYYY-MM-DD |
Nur nativ |
domain_filter |
Maximal 20 Domains; Positivliste oder mit - präfigierte Negativliste, niemals gemischt |
Nur nativ |
max_tokens / max_tokens_per_page |
Inhaltsbudget für alle Ergebnisse / pro Seite | Nur nativ |
Filter, die nur für den nativen Transportweg verfügbar sind, geben im Chat-Completions-Pfad eine aussagekräftige Fehlermeldung 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 anstelle eines
nativen Perplexity-Schlüssels einen OPENROUTER_API_KEY (Präfix sk-or-) fest.
OpenClaw erkennt den Schlüssel und wechselt automatisch zum Sonar-Transportweg.
Dies ist nützlich, wenn Sie die Abrechnung über OpenRouter bereits eingerichtet
haben und Ihre Provider dort zusammenführen möchten.
