Recherche Perplexity

​

Installer le plugin

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

​

Obtenir une clé API Perplexity

1. Créez un compte Perplexity sur perplexity.ai/settings/api.
2. Générez une clé API dans le tableau de bord.
3. Enregistrez la clé dans la configuration ou définissez PERPLEXITY_API_KEY dans l’environnement du Gateway.

​

Compatibilité avec OpenRouter

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

​

Exemples de configuration

​

API Perplexity Search native

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

​

Compatibilité OpenRouter / Sonar

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

​

Où définir la clé

​

Paramètres de l’outil

• query, count et freshness sont acceptés.
• Dans ce cas, count sert uniquement à la compatibilité ; la réponse reste une seule réponse synthétisée avec des citations, et non une liste de N résultats.
• Les filtres réservés à l’API Search (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) renvoient des erreurs explicites.

// Recherche propre à un pays et à une langue
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Résultats récents (semaine écoulée)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Recherche dans une plage de dates
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Filtrage par domaine (liste d’autorisation)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Filtrage par domaine (liste de refus — préfixe -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Extraction de contenu supplémentaire
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Règles de filtrage par domaine

• 20 domaines au maximum par filtre.
• Une même requête ne peut pas mélanger des entrées de liste d’autorisation et de liste de refus.
• Utilisez le préfixe - pour les entrées de la liste de refus (par exemple ["-reddit.com"]).

​

Remarques

• L’API Perplexity Search renvoie des résultats de recherche Web structurés (title, url, snippet).
• OpenRouter, ou la définition explicite de plugins.entries.perplexity.config.webSearch.baseUrl / model, fait rebascule Perplexity vers les complétions de conversation Sonar à des fins de compatibilité.
• La compatibilité Sonar/OpenRouter renvoie une seule réponse synthétisée avec des citations, et non des lignes de résultats structurées.
• Les résultats sont mis en cache pendant 15 minutes par défaut (durée configurable via cacheTtlMinutes).

​

Voir aussi