Skip to main content
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).
Ta strona opisuje konfigurację dostawcy Perplexity. Informacje o narzędziu Perplexity (sposobie korzystania z niego przez agenta) znajdziesz w sekcji Wyszukiwanie Perplexity.

​
Instalowanie pluginu

​
Pierwsze kroki

1

Ustaw klucz API

Możesz też ustawić klucz bezpośrednio:
Działa również klucz wyeksportowany jako PERPLEXITY_API_KEY lub OPENROUTER_API_KEY w środowisku Gateway.
2

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ę:

​
Tryby wyszukiwania

Plugin wybiera mechanizm transportu w następującej kolejności:
  1. Ustawiono webSearch.baseUrl lub webSearch.model: żądania są zawsze kierowane przez uzupełnienia czatu Sonar do tego punktu końcowego, niezależnie od typu klucza.
  2. 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.
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

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

Klucz wyeksportowany wyłącznie w interaktywnej powłoce nie jest widoczny dla demona Gateway uruchamianego przez launchd/systemd, chyba że to środowisko zostanie jawnie zaimportowane. Ustaw klucz w ~/.openclaw/.env lub za pomocą env.shellEnv, aby proces Gateway mógł go odczytać. Pełną kolejność pierwszeństwa opisano w sekcji Zmienne środowiskowe.
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.

​
Powiązane materiały

Narzędzie wyszukiwania Perplexity

Sposób wywoływania wyszukiwań Perplexity przez agenta i interpretowania wyników.

Dokumentacja konfiguracji

Pełna dokumentacja konfiguracji, w tym wpisów pluginów.