Perplexity-zoekopdracht

OpenClaw ondersteunt de Perplexity Search API als een web_search-provider. Deze retourneert gestructureerde resultaten met de velden title, url en snippet.

Voor compatibiliteit ondersteunt OpenClaw ook verouderde Perplexity Sonar/OpenRouter-configuraties. Als je OPENROUTER_API_KEY gebruikt, een sk-or-...-sleutel in plugins.entries.perplexity.config.webSearch.apiKey hebt of plugins.entries.perplexity.config.webSearch.baseUrl / model instelt, schakelt de provider over naar het pad voor chat-completions en retourneert deze door AI samengestelde antwoorden met bronverwijzingen in plaats van gestructureerde resultaten van de Search API.

Plugin installeren

Installeer de officiële Plugin en start daarna de Gateway opnieuw:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Een Perplexity API-sleutel verkrijgen

1. Maak een Perplexity-account aan op perplexity.ai/settings/api.
2. Genereer een API-sleutel in het dashboard.
3. Sla de sleutel op in de configuratie of stel PERPLEXITY_API_KEY in de Gateway-omgeving in.

OpenRouter-compatibiliteit

Als je OpenRouter al voor Perplexity Sonar gebruikte, behoud dan provider: "perplexity" en stel OPENROUTER_API_KEY in de Gateway-omgeving in, of sla een sk-or-...-sleutel op in plugins.entries.perplexity.config.webSearch.apiKey.

Optionele compatibiliteitsinstellingen:

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

Configuratievoorbeelden

Native Perplexity Search API

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "pplx-...",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

OpenRouter-/Sonar-compatibiliteit

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "<openrouter-api-key>",            baseUrl: "https://openrouter.ai/api/v1",            model: "perplexity/sonar-pro",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

Waar je de sleutel instelt

Via de configuratie: voer openclaw configure --section web uit. Hiermee wordt de sleutel opgeslagen in ~/.openclaw/openclaw.json onder plugins.entries.perplexity.config.webSearch.apiKey. Dit veld accepteert ook SecretRef-objecten.

Via de omgeving: stel PERPLEXITY_API_KEY of OPENROUTER_API_KEY in de procesomgeving van de Gateway in. Plaats deze voor een Gateway-installatie in ~/.openclaw/.env (of in je serviceomgeving). Zie Omgevingsvariabelen.

Als provider: "perplexity" is geconfigureerd en de SecretRef van de Perplexity-sleutel niet kan worden omgezet en er geen terugvaloptie via een omgevingsvariabele is, mislukt het opstarten of opnieuw laden onmiddellijk.

Toolparameters

Deze parameters zijn van toepassing op het native pad van de Perplexity Search API.

Voor het verouderde compatibiliteitspad voor Sonar/OpenRouter:

• query, count en freshness worden geaccepteerd.
• count dient daar alleen voor compatibiliteit; het antwoord blijft één samengesteld antwoord met bronverwijzingen in plaats van een lijst met N resultaten.
• Filters die uitsluitend voor de Search API bestemd zijn (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) retourneren expliciete fouten.

Voorbeelden:

// Land- en taalspecifieke zoekopdrachtawait web_search({  query: "hernieuwbare energie",  country: "DE",  language: "de",}); // Recente resultaten (afgelopen week)await web_search({  query: "AI-nieuws",  freshness: "week",}); // Zoeken binnen een datumbereikawait web_search({  query: "AI-ontwikkelingen",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domeinen filteren (toegestane lijst)await web_search({  query: "klimaatonderzoek",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Domeinen filteren (blokkeerlijst - gebruik - als voorvoegsel)await web_search({  query: "productbeoordelingen",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Meer inhoud extraherenawait web_search({  query: "gedetailleerd AI-onderzoek",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Regels voor domeinfilters

• Maximaal 20 domeinen per filter.
• Je kunt vermeldingen uit de lijst met toegestane domeinen en de blokkeerlijst niet in hetzelfde verzoek combineren.
• Gebruik het voorvoegsel - voor vermeldingen in de blokkeerlijst (bijv. ["-reddit.com"]).

Opmerkingen

• De Perplexity Search API retourneert gestructureerde webzoekresultaten (title, url, snippet).
• OpenRouter, of een expliciete plugins.entries.perplexity.config.webSearch.baseUrl / model, schakelt Perplexity voor compatibiliteit terug naar Sonar-chat-completions.
• Sonar-/OpenRouter-compatibiliteit retourneert één samengesteld antwoord met bronverwijzingen, geen gestructureerde resultaatrijen.
• Resultaten worden standaard 15 minuten in de cache opgeslagen (configureerbaar via cacheTtlMinutes).

Gerelateerd