Providers
Perplexity
Plugin Perplexity rejestruje dostawcę web_search z dwoma mechanizmami transportu: natywnym interfejsem Perplexity Search API (ustrukturyzowane wyniki z filtrami) oraz uzupełnieniami czatu Perplexity Sonar, bezpośrednio lub przez OpenRouter (odpowiedzi syntetyzowane przez AI z cytowaniami).
| Właściwość | Wartość |
|---|---|
| Typ | Dostawca wyszukiwania internetowego (nie dostawca modelu) |
| Uwierzytelnianie | PERPLEXITY_API_KEY (natywnie) lub OPENROUTER_API_KEY (przez OpenRouter) |
| Ścieżka konfiguracji | plugins.entries.perplexity.config.webSearch.apiKey |
| Nadpisania | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| Pobieranie klucza | perplexity.ai/settings/api |
Instalowanie pluginu
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartPierwsze kroki
Ustaw klucz API
openclaw configure --section webMożesz też ustawić klucz bezpośrednio:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Działa również klucz wyeksportowany jako PERPLEXITY_API_KEY lub OPENROUTER_API_KEY w środowisku Gateway.
Rozpocznij wyszukiwanie
web_search automatycznie wykrywa Perplexity, gdy jego klucz jest dostępnymi danymi uwierzytelniającymi wyszukiwania; dodatkowa konfiguracja nie jest wymagana. Aby jawnie przypisać dostawcę:
openclaw config set tools.web.search.provider perplexityTryby wyszukiwania
Plugin wybiera mechanizm transportu w następującej kolejności:
- Ustawiono
webSearch.baseUrllubwebSearch.model: żądania są zawsze kierowane przez uzupełnienia czatu Sonar do tego punktu końcowego, niezależnie od typu klucza. - W przeciwnym razie źródło klucza określa punkt końcowy: prefiks skonfigurowanego klucza wybiera mechanizm transportu (konfiguracja ma pierwszeństwo przed zmiennymi środowiskowymi), a klucz środowiskowy bezpośrednio używa odpowiadającego mu punktu końcowego.
| Prefiks klucza | Mechanizm transportu | Funkcje |
|---|---|---|
pplx- |
Natywny Perplexity Search API (https://api.perplexity.ai) |
Ustrukturyzowane wyniki, filtry domeny, języka i daty |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1), model Sonar |
Odpowiedzi syntetyzowane przez AI z cytowaniami |
Skonfigurowany klucz z dowolnym innym prefiksem również korzysta z natywnego Search API. Ścieżka uzupełnień czatu domyślnie używa modelu perplexity/sonar-pro; możesz go nadpisać za pomocą plugins.entries.perplexity.config.webSearch.model.
Filtrowanie natywnego API
| Filtr | Opis | Mechanizm transportu |
|---|---|---|
count |
Liczba wyników na wyszukiwanie, 1–10 (domyślnie 5) | Tylko natywny |
freshness |
Przedział aktualności: day, week, month, year |
Oba |
country |
Dwuliterowy kod kraju (us, de, jp) |
Tylko natywny |
language |
Kod języka ISO 639-1 (en, fr, zh) |
Tylko natywny |
date_after / date_before |
Zakres dat publikacji w formacie YYYY-MM-DD |
Tylko natywny |
domain_filter |
Maks. 20 domen; lista dozwolonych lub lista blokowanych z prefiksem -, nigdy obie naraz |
Tylko natywny |
max_tokens / max_tokens_per_page |
Budżet zawartości dla wszystkich wyników / na stronę | Tylko natywny |
Filtry dostępne tylko w trybie natywnym zwracają opisowy błąd w ścieżce uzupełnień czatu. Parametru freshness nie można łączyć z date_after/date_before.
Konfiguracja zaawansowana
Zmienna środowiskowa dla procesów demona
Konfiguracja proxy OpenRouter
Aby kierować wyszukiwania Perplexity przez OpenRouter, ustaw OPENROUTER_API_KEY (prefiks sk-or-) zamiast natywnego klucza Perplexity. OpenClaw wykrywa klucz i automatycznie przełącza się na mechanizm transportu Sonar. Jest to przydatne, jeśli rozliczenia OpenRouter są już skonfigurowane i chcesz skonsolidować tam dostawców.
