Skip to main content
Il plugin Perplexity registra un provider web_search con due modalità di trasporto: l’API nativa Perplexity Search (risultati strutturati con filtri) e i completamenti chat Perplexity Sonar, direttamente o tramite OpenRouter (risposte sintetizzate dall’IA con citazioni).
Questa pagina descrive la configurazione del provider Perplexity. Per lo strumento Perplexity (come viene utilizzato dall’agente), consulta Ricerca Perplexity.

​
Installare il plugin

​
Per iniziare

1

Imposta la chiave API

In alternativa, imposta direttamente la chiave:
Funziona anche una chiave esportata come PERPLEXITY_API_KEY o OPENROUTER_API_KEY nell’ambiente del Gateway.
2

Inizia a cercare

web_search rileva automaticamente Perplexity quando la relativa chiave è la credenziale di ricerca disponibile; non è necessaria alcuna configurazione aggiuntiva. Per specificare esplicitamente il provider:

​
Modalità di ricerca

Il plugin determina la modalità di trasporto nel seguente ordine:
  1. Se webSearch.baseUrl o webSearch.model è impostato, instrada sempre la richiesta tramite i completamenti chat Sonar verso tale endpoint, indipendentemente dal tipo di chiave.
  2. In caso contrario, l’origine della chiave determina l’endpoint: il prefisso di una chiave configurata seleziona la modalità di trasporto (la configurazione ha la precedenza sulle variabili d’ambiente); una chiave d’ambiente utilizza direttamente l’endpoint corrispondente.
Una chiave configurata con qualsiasi altro prefisso utilizza anch’essa l’API Search nativa. Il percorso dei completamenti chat utilizza per impostazione predefinita il modello perplexity/sonar-pro; puoi sostituirlo con plugins.entries.perplexity.config.webSearch.model.

​
Filtri dell’API nativa

I filtri disponibili solo per l’API nativa restituiscono un errore descrittivo nel percorso dei completamenti chat. freshness non può essere combinato con date_after/date_before.

​
Configurazione avanzata

Una chiave esportata esclusivamente in una shell interattiva non è visibile a un daemon Gateway launchd/systemd, a meno che tale ambiente non venga importato esplicitamente. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv affinché il processo Gateway possa leggerla. Consulta Variabili d’ambiente per l’ordine completo di precedenza.
Per instradare le ricerche Perplexity tramite OpenRouter, imposta una OPENROUTER_API_KEY (prefisso sk-or-) anziché una chiave Perplexity nativa. OpenClaw rileva la chiave e passa automaticamente alla modalità di trasporto Sonar. È utile se hai già configurato la fatturazione di OpenRouter e desideri consolidare lì i provider.

​
Contenuti correlati

Strumento di ricerca Perplexity

Come l’agente richiama le ricerche Perplexity e interpreta i risultati.

Riferimento della configurazione

Riferimento completo della configurazione, incluse le voci dei plugin.