Ricerca Perplexity

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

Per compatibilità, OpenClaw supporta anche le configurazioni legacy Perplexity Sonar/OpenRouter. Se usi 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 chat-completions e restituisce risposte sintetizzate dall'IA con citazioni invece di risultati strutturati della Search API.

Ottenere una chiave API Perplexity

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

Compatibilità con OpenRouter

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

Controlli di compatibilità opzionali:

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

Esempi di configurazione

Search API Perplexity nativa

{  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",      },    },  },}

Dove impostare la chiave

Tramite configurazione: esegui openclaw configure --section web. Archivia la chiave in ~/.openclaw/openclaw.json sotto plugins.entries.perplexity.config.webSearch.apiKey. Quel 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 tuo servizio). Vedi Variabili d'ambiente.

Se provider: "perplexity" è configurato e la SecretRef della chiave Perplexity non viene risolta senza fallback env, l'avvio/ricaricamento fallisce rapidamente.

Parametri dello strumento

Questi parametri si applicano al percorso nativo Perplexity Search API.

Per il percorso di compatibilità legacy Sonar/OpenRouter:

• query, count e freshness sono accettati
• count lì è solo per compatibilità; la risposta è comunque una sola risposta sintetizzata con citazioni invece di un elenco di N risultati
• I filtri disponibili solo nella Search API, come country, language, date_after, date_before, domain_filter, max_tokens e max_tokens_per_page restituiscono errori espliciti

Esempi:

// Country and language-specific searchawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Recent results (past week)await web_search({  query: "AI news",  freshness: "week",}); // Date range searchawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domain filtering (allowlist)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Domain filtering (denylist - prefix with -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // More content extractionawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Regole dei filtri di dominio

• Massimo 20 domini per filtro
• Non è possibile mescolare allowlist e denylist nella stessa richiesta
• Usa il prefisso - per le voci denylist (ad esempio ["-reddit.com"])

Note

• Perplexity Search API restituisce risultati di ricerca web strutturati (title, url, snippet)
• OpenRouter o plugins.entries.perplexity.config.webSearch.baseUrl / model espliciti riportano Perplexity alle chat completions Sonar per compatibilità
• La compatibilità Sonar/OpenRouter restituisce una sola risposta sintetizzata con citazioni, non righe di risultati strutturati
• I risultati vengono memorizzati nella cache per 15 minuti per impostazione predefinita (configurabile tramite cacheTtlMinutes)

Correlati