Vai al contenuto principale
Il plugin Perplexity fornisce funzionalità di ricerca web tramite la Perplexity Search API o Perplexity Sonar tramite OpenRouter.
Questa pagina riguarda 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

​
Installa il plugin

Installa il plugin ufficiale, quindi riavvia Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
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

L’agente userà automaticamente Perplexity per le ricerche web una volta che la chiave è configurata. Non sono necessari 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 la Perplexity Search API nativa. Questo trasporto restituisce risultati strutturati e supporta filtri per dominio, lingua e data (vedi le opzioni di filtro sotto).
Prefisso chiaveTrasportoFunzionalità
pplx-Perplexity Search API nativaRisultati strutturati, filtri dominio/lingua/data
sk-or-OpenRouter (Sonar)Risposte sintetizzate dall’IA 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 si usa l’API Perplexity nativa, le ricerche supportano i seguenti filtri:
FiltroDescrizioneEsempio
PaeseCodice paese a 2 lettereus, de, jp
LinguaCodice lingua ISO 639-1en, fr, zh
Intervallo dateFinestra di attualitàday, week, month, year
Filtri dominioAllowlist o denylist (max 20 domini)example.com
Budget contenutiLimiti di token per risposta / per paginamax_tokens, max_tokens_per_page

​
Configurazione avanzata

Se OpenClaw Gateway viene eseguito come daemon (launchd/systemd), assicurati che PERPLEXITY_API_KEY sia disponibile per quel processo.
Una chiave esportata solo in una shell interattiva 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 di configurazione

Riferimento completo alla configurazione, incluse le voci dei plugin.