Skip to main content
De Perplexity-plugin registreert een web_search-provider met twee transportmethoden: de native Perplexity Search API (gestructureerde resultaten met filters) en Perplexity Sonar-chatvoltooiingen, rechtstreeks of via OpenRouter (door AI samengestelde antwoorden met bronverwijzingen).
Deze pagina behandelt de configuratie van de Perplexity-provider. Zie Zoeken met Perplexity voor de Perplexity-tool (hoe de agent deze gebruikt).

​
Plugin installeren

​
Aan de slag

1

Stel de API-sleutel in

Of stel de sleutel rechtstreeks in:
Een sleutel die als PERPLEXITY_API_KEY of OPENROUTER_API_KEY in de Gateway-omgeving is geëxporteerd, werkt ook.
2

Begin met zoeken

web_search detecteert Perplexity automatisch zodra de sleutel de beschikbare zoekreferentie is; verdere configuratie is niet nodig. Om de provider expliciet vast te zetten:

​
Zoekmodi

De Plugin bepaalt de transportmethode in deze volgorde:
  1. webSearch.baseUrl of webSearch.model ingesteld: routeert altijd via Sonar-chatvoltooiingen naar dat eindpunt, ongeacht het sleuteltype.
  2. Anders bepaalt de bron van de sleutel het eindpunt: het voorvoegsel van een geconfigureerde sleutel selecteert de transportmethode (configuratie heeft voorrang op omgevingsvariabelen); een omgevingssleutel gebruikt rechtstreeks het bijbehorende eindpunt.
Een geconfigureerde sleutel met een ander voorvoegsel gebruikt eveneens de native Search API. Het chatvoltooiingspad gebruikt standaard het perplexity/sonar-pro-model; overschrijf dit met plugins.entries.perplexity.config.webSearch.model.

​
Filters voor de native API

Filters die alleen native beschikbaar zijn, retourneren een beschrijvende fout in het chatvoltooiingspad. freshness kan niet worden gecombineerd met date_after/date_before.

​
Geavanceerde configuratie

Een sleutel die alleen in een interactieve shell is geëxporteerd, is niet zichtbaar voor een launchd/systemd-Gateway-daemon, tenzij die omgeving expliciet wordt geïmporteerd. Stel de sleutel in ~/.openclaw/.env of via env.shellEnv in, zodat het Gateway-proces deze kan lezen. Zie Omgevingsvariabelen voor de volledige prioriteitsvolgorde.
Om Perplexity-zoekopdrachten via OpenRouter te routeren, stel je een OPENROUTER_API_KEY (voorvoegsel sk-or-) in in plaats van een native Perplexity-sleutel. OpenClaw detecteert de sleutel en schakelt automatisch over naar de Sonar-transportmethode. Dit is handig als je al facturering via OpenRouter hebt ingesteld en providers daar wilt consolideren.

​
Gerelateerd

Perplexity-zoektool

Hoe de agent Perplexity-zoekopdrachten aanroept en resultaten interpreteert.

Configuratiereferentie

Volledige configuratiereferentie, inclusief Plugin-vermeldingen.