Perplexity-Suche

​

Plugin installieren

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​

Perplexity-API-Schlüssel beziehen

1. Erstellen Sie unter perplexity.ai/settings/api ein Perplexity-Konto.
2. Generieren Sie im Dashboard einen API-Schlüssel.
3. Speichern Sie den Schlüssel in der Konfiguration oder setzen Sie PERPLEXITY_API_KEY in der Gateway-Umgebung.

​

OpenRouter-Kompatibilität

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

​

Konfigurationsbeispiele

​

Native Perplexity Search API

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

​

OpenRouter-/Sonar-Kompatibilität

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

​

Wo der Schlüssel festgelegt wird

​

Tool-Parameter

• query, count und freshness werden akzeptiert.
• count dient dort nur der Kompatibilität; die Antwort besteht weiterhin aus einer einzigen generierten Antwort mit Quellenangaben statt aus einer Liste mit N Ergebnissen.
• Filter, die ausschließlich für die Search API gelten (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page), geben explizite Fehler zurück.

// Länder- und sprachspezifische Suche
await web_search({
  query: "erneuerbare Energie",
  country: "DE",
  language: "de",
});

// Aktuelle Ergebnisse (vergangene Woche)
await web_search({
  query: "KI-Nachrichten",
  freshness: "week",
});

// Suche nach Datumsbereich
await web_search({
  query: "KI-Entwicklungen",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domainfilterung (Zulassungsliste)
await web_search({
  query: "Klimaforschung",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Domainfilterung (Sperrliste – mit - voranstellen)
await web_search({
  query: "Produktbewertungen",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Umfangreichere Inhaltsextraktion
await web_search({
  query: "detaillierte KI-Forschung",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Regeln für Domainfilter

• Maximal 20 Domains pro Filter.
• Einträge aus Zulassungs- und Sperrlisten dürfen nicht in derselben Anfrage kombiniert werden.
• Verwenden Sie für Sperrlisteneinträge das Präfix - (z. B. ["-reddit.com"]).

​

Hinweise

• Die Perplexity Search API gibt strukturierte Websuchergebnisse zurück (title, url, snippet).
• OpenRouter oder explizite Angaben für plugins.entries.perplexity.config.webSearch.baseUrl / model stellen Perplexity aus Kompatibilitätsgründen wieder auf Sonar Chat Completions um.
• Die Sonar-/OpenRouter-Kompatibilität gibt eine einzige generierte Antwort mit Quellenangaben zurück, keine strukturierten Ergebniszeilen.
• Ergebnisse werden standardmäßig 15 Minuten zwischengespeichert (über cacheTtlMinutes konfigurierbar).

​

Verwandte Themen