Naar hoofdinhoud gaan
De Perplexity-plugin biedt mogelijkheden voor zoeken op het web via de Perplexity Search API of Perplexity Sonar via OpenRouter.
Deze pagina beschrijft de configuratie van de Perplexity-provider. Zie Perplexity-tool voor de Perplexity-tool (hoe de agent die gebruikt).
EigenschapWaarde
TypeProvider voor zoeken op het web (geen modelprovider)
AuthPERPLEXITY_API_KEY (direct) of OPENROUTER_API_KEY (via OpenRouter)
Configuratiepadplugins.entries.perplexity.config.webSearch.apiKey

​
Plugin installeren

Installeer de officiële Plugin en herstart daarna Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Aan de slag

1

De API-sleutel instellen

Voer de interactieve configuratiestroom voor zoeken op het web uit:
openclaw configure --section web
Of stel de sleutel direct in:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Beginnen met zoeken

De agent gebruikt Perplexity automatisch voor zoekopdrachten op het web zodra de sleutel is geconfigureerd. Er zijn geen extra stappen vereist.

​
Zoekmodi

De plugin selecteert automatisch het transport op basis van het API-sleutelvoorvoegsel:
Wanneer je sleutel begint met pplx-, gebruikt OpenClaw de native Perplexity Search API. Dit transport retourneert gestructureerde resultaten en ondersteunt domein-, taal- en datumfilters (zie de filteropties hieronder).
SleutelvoorvoegselTransportFuncties
pplx-Native Perplexity Search APIGestructureerde resultaten, domein-/taal-/datumfilters
sk-or-OpenRouter (Sonar)Door AI samengestelde antwoorden met citaties

​
Filteren met de native API

Filteropties zijn alleen beschikbaar wanneer je de native Perplexity API gebruikt (pplx--sleutel). OpenRouter/Sonar-zoekopdrachten ondersteunen deze parameters niet.
Bij gebruik van de native Perplexity API ondersteunen zoekopdrachten de volgende filters:
FilterBeschrijvingVoorbeeld
LandLandcode van 2 lettersus, de, jp
TaalISO 639-1-taalcodeen, fr, zh
DatumbereikRecency-vensterday, week, month, year
DomeinfiltersToestemmingslijst of blokkeerlijst (max. 20 domeinen)example.com
ContentbudgetTokenlimieten per antwoord / per paginamax_tokens, max_tokens_per_page

​
Geavanceerde configuratie

Als de OpenClaw Gateway als daemon draait (launchd/systemd), zorg er dan voor dat PERPLEXITY_API_KEY beschikbaar is voor dat proces.
Een sleutel die alleen in een interactieve shell is geëxporteerd, is niet zichtbaar voor een launchd/systemd-daemon tenzij die omgeving expliciet wordt geïmporteerd. Stel de sleutel in ~/.openclaw/.env of via env.shellEnv in om ervoor te zorgen dat het gateway- proces deze kan lezen.
Als je Perplexity-zoekopdrachten liever via OpenRouter routeert, stel dan een OPENROUTER_API_KEY (voorvoegsel sk-or-) in in plaats van een native Perplexity-sleutel. OpenClaw detecteert het voorvoegsel en schakelt automatisch over naar het Sonar-transport.
Het OpenRouter-transport is nuttig als je al een OpenRouter-account hebt en geconsolideerde facturering voor meerdere providers wilt.

​
Gerelateerd

Perplexity-zoektool

Hoe de agent Perplexity-zoekopdrachten aanroept en resultaten interpreteert.

Configuratiereferentie

Volledige configuratiereferentie inclusief pluginvermeldingen.