OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Perplexity

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).

Eigenschap Waarde
Type Webzoekprovider (geen modelprovider)
Auth PERPLEXITY_API_KEY (native) of OPENROUTER_API_KEY (via OpenRouter)
Configuratiepad plugins.entries.perplexity.config.webSearch.apiKey
Overschrijvingen plugins.entries.perplexity.config.webSearch.baseUrl / .model
Sleutel verkrijgen perplexity.ai/settings/api

Plugin installeren

bash
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Aan de slag

  • Stel de API-sleutel in

    bash
    openclaw configure --section web

    Of stel de sleutel rechtstreeks in:

    bash
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

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

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

    bash
    openclaw config set tools.web.search.provider perplexity

    • 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.
    Sleutelvoorvoegsel Transport Functies
    pplx- Native Perplexity Search API (https://api.perplexity.ai) Gestructureerde resultaten, domein-/taal-/datumfilters
    sk-or- OpenRouter (https://openrouter.ai/api/v1), Sonar-model Door AI samengestelde antwoorden met bronverwijzingen

    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

    Filter Beschrijving Transport
    count Resultaten per zoekopdracht, 1-10 (standaard 5) Alleen native
    freshness Recentheidsperiode: day, week, month, year Beide
    country Landcode van 2 letters (us, de, jp) Alleen native
    language ISO 639-1-taalcode (en, fr, zh) Alleen native
    date_after / date_before Publicatiedatumbereik in YYYY-MM-DD Alleen native
    domain_filter Maximaal 20 domeinen; acceptatielijst of weigeringslijst met het voorvoegsel -, nooit gecombineerd Alleen native
    max_tokens / max_tokens_per_page Inhoudsbudget voor alle resultaten / per pagina Alleen native

    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

    Omgevingsvariabele voor daemonprocessen
    OpenRouter-proxy configureren

    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.
    Was this useful?
    On this page

    On this page