Przejdź do głównej treści
Plugin Perplexity zapewnia możliwości wyszukiwania w sieci za pośrednictwem Perplexity Search API lub Perplexity Sonar przez OpenRouter.
Ta strona dotyczy konfiguracji dostawcy Perplexity. Informacje o narzędziu Perplexity (jak używa go agent) znajdziesz w sekcji Narzędzie Perplexity.
WłaściwośćWartość
TypDostawca wyszukiwania w sieci (nie dostawca modeli)
UwierzytelnianiePERPLEXITY_API_KEY (bezpośrednio) lub OPENROUTER_API_KEY (przez OpenRouter)
Ścieżka konfiguracjiplugins.entries.perplexity.config.webSearch.apiKey

​
Instalacja Plugin

Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Pierwsze kroki

1

Ustaw klucz API

Uruchom interaktywny przepływ konfiguracji wyszukiwania w sieci:
openclaw configure --section web
Albo ustaw klucz bezpośrednio:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Rozpocznij wyszukiwanie

Agent automatycznie zacznie używać Perplexity do wyszukiwań w sieci po skonfigurowaniu klucza. Nie są wymagane żadne dodatkowe kroki.

​
Tryby wyszukiwania

Plugin automatycznie wybiera transport na podstawie prefiksu klucza API:
Gdy klucz zaczyna się od pplx-, OpenClaw używa natywnego Perplexity Search API. Ten transport zwraca ustrukturyzowane wyniki i obsługuje filtry domen, języka oraz dat (zobacz opcje filtrowania poniżej).
Prefiks kluczaTransportFunkcje
pplx-Natywne Perplexity Search APIUstrukturyzowane wyniki, filtry domen/języka/dat
sk-or-OpenRouter (Sonar)Odpowiedzi syntetyzowane przez AI z cytowaniami

​
Filtrowanie w natywnym API

Opcje filtrowania są dostępne tylko podczas korzystania z natywnego API Perplexity (klucz pplx-). Wyszukiwania OpenRouter/Sonar nie obsługują tych parametrów.
Podczas korzystania z natywnego API Perplexity wyszukiwania obsługują następujące filtry:
FiltrOpisPrzykład
KrajDwuliterowy kod krajuus, de, jp
JęzykKod języka ISO 639-1en, fr, zh
Zakres datOkno aktualnościday, week, month, year
Filtry domenLista dozwolonych lub blokowanych domen (maks. 20 domen)example.com
Budżet treściLimity tokenów na odpowiedź / na stronęmax_tokens, max_tokens_per_page

​
Konfiguracja zaawansowana

Jeśli OpenClaw Gateway działa jako demon (launchd/systemd), upewnij się, że PERPLEXITY_API_KEY jest dostępny dla tego procesu.
Klucz wyeksportowany tylko w interaktywnej powłoce nie będzie widoczny dla demona launchd/systemd, chyba że to środowisko zostanie jawnie zaimportowane. Ustaw klucz w ~/.openclaw/.env lub przez env.shellEnv, aby mieć pewność, że proces gateway może go odczytać.
Jeśli wolisz kierować wyszukiwania Perplexity przez OpenRouter, ustaw OPENROUTER_API_KEY (prefiks sk-or-) zamiast natywnego klucza Perplexity. OpenClaw wykryje prefiks i automatycznie przełączy się na transport Sonar.
Transport OpenRouter jest przydatny, jeśli masz już konto OpenRouter i chcesz skonsolidować rozliczenia u wielu dostawców.

​
Powiązane

Narzędzie wyszukiwania Perplexity

Jak agent wywołuje wyszukiwania Perplexity i interpretuje wyniki.

Dokumentacja konfiguracji

Pełna dokumentacja konfiguracji, w tym wpisy Plugin.