Perplexity-zoekopdracht

​

Plugin installeren

openclaw plugins install @openclaw/perplexity-plugin
openclaw 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

• 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

​

Toolparameters

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

// Land- en taalspecifieke zoekopdracht
await web_search({
  query: "hernieuwbare energie",
  country: "DE",
  language: "de",
});

// Recente resultaten (afgelopen week)
await web_search({
  query: "AI-nieuws",
  freshness: "week",
});

// Zoeken binnen een datumbereik
await 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 extraheren
await 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