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

  • De API-sleutel instellen

    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.

  • Beginnen met zoeken

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

    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 sleutelbron het eindpunt: het voorvoegsel van een geconfigureerde sleutel bepaalt de transportmethode (configuratie heeft voorrang op omgevingsvariabelen); een omgevingssleutel gebruikt rechtstreeks het bijbehorende eindpunt.
    Sleutelvoorvoegsel Transportmethode 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 pad voor chatvoltooiingen gebruikt standaard het model perplexity/sonar-pro; overschrijf dit met plugins.entries.perplexity.config.webSearch.model.

    Filteren met de native API

    Filter Beschrijving Transportmethode
    count Resultaten per zoekopdracht, 1-10 (standaard 5) Alleen native
    freshness Recentheidsvenster: day, week, month, year Beide
    country Landcode van twee 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; toelatingslijst of met - voorafgegane blokkeerlijst, nooit gemengd Alleen native
    max_tokens / max_tokens_per_page Inhoudsbudget voor alle resultaten / per pagina Alleen native

    Filters die alleen voor de native API gelden, retourneren een beschrijvende fout bij het pad voor chatvoltooiingen. freshness kan niet worden gecombineerd met date_after/date_before.

    Geavanceerde configuratie

    Omgevingsvariabele voor daemonprocessen
    OpenRouter-proxyconfiguratie

    Om Perplexity-zoekopdrachten via OpenRouter te routeren, stelt u een OPENROUTER_API_KEY (voorvoegsel sk-or-) in in plaats van een native Perplexity-sleutel. OpenClaw detecteert de sleutel en schakelt automatisch over op de Sonar-transportmethode. Dit is nuttig als u facturering via OpenRouter al hebt ingesteld en providers daar wilt consolideren.

    Gerelateerd

    Perplexity-zoektool

    Hoe de agent Perplexity-zoekopdrachten aanroept en resultaten interpreteert.
    Configuratiereferentie

    Volledige configuratiereferentie, inclusief pluginvermeldingen.
    Was this useful?
    On this page

    On this page