Vai al contenuto principale

​
Perplexity (provider di ricerca web)

Il plugin Perplexity fornisce capacità di ricerca web tramite l’API Perplexity Search o Perplexity Sonar tramite OpenRouter.
Questa pagina copre la configurazione del provider Perplexity. Per lo strumento Perplexity (come lo usa l’agente), vedi Perplexity tool.
  • Tipo: provider di ricerca web (non un provider di modelli)
  • Autenticazione: PERPLEXITY_API_KEY (diretta) oppure OPENROUTER_API_KEY (tramite OpenRouter)
  • Percorso di configurazione: plugins.entries.perplexity.config.webSearch.apiKey

​
Avvio rapido

  1. Imposta la chiave API:
openclaw configure --section web
Oppure impostala direttamente: 
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
  1. L’agente userà automaticamente Perplexity per le ricerche web quando configurato.

​
Modalità di ricerca

Il plugin seleziona automaticamente il trasporto in base al prefisso della chiave API:
Prefisso chiaveTrasportoFunzionalità
pplx-API Search nativa di PerplexityRisultati strutturati, filtri per dominio/lingua/data
sk-or-OpenRouter (Sonar)Risposte sintetizzate dall’AI con citazioni

​
Filtraggio dell’API nativa

Quando si usa l’API nativa di Perplexity (pplx- key), le ricerche supportano:
  • Paese: codice paese di 2 lettere
  • Lingua: codice lingua ISO 639-1
  • Intervallo di date: giorno, settimana, mese, anno
  • Filtri di dominio: allowlist/denylist (massimo 20 domini)
  • Budget del contenuto: max_tokens, max_tokens_per_page

​
Nota sull’ambiente

Se il Gateway viene eseguito come daemon (launchd/systemd), assicurati che PERPLEXITY_API_KEY sia disponibile per quel processo (ad esempio in ~/.openclaw/.env o tramite env.shellEnv).