Ricerca Perplexity

OpenClaw supporta l'API Perplexity Search come provider di web_search. Restituisce risultati strutturati con i campi title, url e snippet.

Per compatibilità, OpenClaw supporta anche le configurazioni legacy di Perplexity Sonar/OpenRouter. Se utilizzi OPENROUTER_API_KEY, una chiave sk-or-... in plugins.entries.perplexity.config.webSearch.apiKey oppure imposti plugins.entries.perplexity.config.webSearch.baseUrl / model, il provider passa al percorso delle chat completions e restituisce risposte sintetizzate dall'IA con citazioni anziché risultati strutturati dell'API Search.

Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia il Gateway:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Ottenere una chiave API Perplexity

1. Crea un account Perplexity su perplexity.ai/settings/api.
2. Genera una chiave API nella dashboard.
3. Salva la chiave nella configurazione oppure imposta PERPLEXITY_API_KEY nell'ambiente del Gateway.

Compatibilità con OpenRouter

Se utilizzavi già OpenRouter per Perplexity Sonar, mantieni provider: "perplexity" e imposta OPENROUTER_API_KEY nell'ambiente del Gateway, oppure salva una chiave sk-or-... in plugins.entries.perplexity.config.webSearch.apiKey.

Controlli di compatibilità facoltativi:

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

Esempi di configurazione

API Perplexity Search nativa

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

Compatibilità con 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",      },    },  },}

Dove impostare la chiave

Tramite configurazione: esegui openclaw configure --section web. La chiave viene salvata in ~/.openclaw/openclaw.json nel campo plugins.entries.perplexity.config.webSearch.apiKey. Tale campo accetta anche oggetti SecretRef.

Tramite ambiente: imposta PERPLEXITY_API_KEY o OPENROUTER_API_KEY nell'ambiente del processo Gateway. Per un'installazione del Gateway, inseriscila in ~/.openclaw/.env (o nell'ambiente del servizio). Consulta Variabili d'ambiente.

Se è configurato provider: "perplexity" e il SecretRef della chiave Perplexity non viene risolto, senza alcun valore di riserva nell'ambiente, l'avvio o il ricaricamento termina immediatamente con un errore.

Parametri dello strumento

Questi parametri si applicano al percorso dell'API Perplexity Search nativa.

Per il percorso legacy di compatibilità Sonar/OpenRouter:

• Sono accettati query, count e freshness.
• In questo percorso, count è disponibile solo per compatibilità; la risposta rimane un'unica risposta sintetizzata con citazioni, anziché un elenco di N risultati.
• I filtri esclusivi dell'API Search (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) restituiscono errori espliciti.

Esempi:

// Ricerca specifica per paese e linguaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Risultati recenti (ultima settimana)await web_search({  query: "AI news",  freshness: "week",}); // Ricerca per intervallo di dateawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Filtro per dominio (elenco consentiti)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Filtro per dominio (elenco esclusi: prefisso -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Estrazione di più contenutiawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Regole del filtro per dominio

• Massimo 20 domini per filtro.
• Non è possibile combinare voci consentite ed escluse nella stessa richiesta.
• Utilizza il prefisso - per le voci escluse (ad esempio ["-reddit.com"]).

Note

• L'API Perplexity Search restituisce risultati di ricerca web strutturati (title, url, snippet).
• OpenRouter, oppure un valore esplicito per plugins.entries.perplexity.config.webSearch.baseUrl / model, fa tornare Perplexity alle chat completions di Sonar per compatibilità.
• La compatibilità Sonar/OpenRouter restituisce un'unica risposta sintetizzata con citazioni, non righe di risultati strutturati.
• Per impostazione predefinita, i risultati vengono memorizzati nella cache per 15 minuti (configurabile tramite cacheTtlMinutes).

Contenuti correlati