Vai al contenuto principale

​
Perplexity (Provider di ricerca web)

Il Plugin Perplexity fornisce funzionalità di ricerca web tramite l’API di ricerca Perplexity o Perplexity Sonar tramite OpenRouter.
Questa pagina descrive la configurazione del provider Perplexity. Per lo strumento Perplexity (come lo usa l’agente), vedi Strumento Perplexity.
ProprietàValore
TipoProvider di ricerca web (non un provider di modelli)
AuthPERPLEXITY_API_KEY (diretta) o OPENROUTER_API_KEY (tramite OpenRouter)
Percorso configplugins.entries.perplexity.config.webSearch.apiKey

​
Per iniziare

1

Imposta la chiave API

Esegui il flusso interattivo di configurazione della ricerca web:
openclaw configure --section web
Oppure imposta direttamente la chiave:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Inizia a cercare

Una volta configurata la chiave, l’agente userà automaticamente Perplexity per le ricerche web. Non sono richiesti passaggi aggiuntivi.

​
Modalità di ricerca

Il Plugin seleziona automaticamente il trasporto in base al prefisso della chiave API:
Quando la tua chiave inizia con pplx-, OpenClaw usa l’API di ricerca nativa di Perplexity. Questo trasporto restituisce risultati strutturati e supporta filtri per dominio, lingua e data (vedi le opzioni di filtro qui sotto).
Prefisso chiaveTrasportoFunzionalità
pplx-API di ricerca Perplexity nativaRisultati strutturati, filtri per dominio/lingua/data
sk-or-OpenRouter (Sonar)Risposte sintetizzate dall’AI con citazioni

​
Filtri dell’API nativa

Le opzioni di filtro sono disponibili solo quando si usa l’API Perplexity nativa (chiave pplx-). Le ricerche OpenRouter/Sonar non supportano questi parametri.
Quando usi l’API Perplexity nativa, le ricerche supportano i seguenti filtri:
FiltroDescrizioneEsempio
PaeseCodice paese di 2 lettereus, de, jp
LinguaCodice lingua ISO 639-1en, fr, zh
Intervallo dateFinestra di recenzaday, week, month, year
Filtri dominioAllowlist o denylist (max 20 domini)example.com
Budget contenutoLimiti di token per risposta / per paginamax_tokens, max_tokens_per_page

​
Note avanzate

Se il Gateway OpenClaw viene eseguito come daemon (launchd/systemd), assicurati che PERPLEXITY_API_KEY sia disponibile per quel processo.
Una chiave impostata solo in ~/.profile non sarà visibile a un daemon launchd/systemd a meno che quell’ambiente non venga importato esplicitamente. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per assicurarti che il processo gateway possa leggerla.
Se preferisci instradare le ricerche Perplexity tramite OpenRouter, imposta una OPENROUTER_API_KEY (prefisso sk-or-) invece di una chiave Perplexity nativa. OpenClaw rileverà il prefisso e passerà automaticamente al trasporto Sonar.
Il trasporto OpenRouter è utile se hai già un account OpenRouter e vuoi una fatturazione consolidata tra più provider.

​
Correlati

Strumento di ricerca Perplexity

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

Riferimento della configurazione

Riferimento completo della configurazione, incluse le voci dei Plugin.