Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Il Plugin Perplexity fornisce funzionalità di ricerca web tramite l’API di ricerca Perplexity o Perplexity Sonar tramite OpenRouter.
Questa pagina riguarda la configurazione del provider Perplexity. Per lo strumento Perplexity (come l’agente lo usa), vedi strumento Perplexity.
ProprietàValore
TipoProvider di ricerca web (non un provider di modelli)
AutenticazionePERPLEXITY_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

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 l’API di ricerca Perplexity nativa. Questo trasporto restituisce risultati strutturati e supporta filtri per dominio, lingua e data (vedi le opzioni di filtro sotto).
Prefisso chiaveTrasportoFunzionalità
pplx-API di ricerca Perplexity 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 usi 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 a 2 lettereus, de, jp
LinguaCodice lingua ISO 639-1en, fr, zh
Intervallo di dateFinestra di recenzaday, week, month, year
Filtri dominioAllowlist o denylist (massimo 20 domini)example.com
Budget contenutoLimiti di token per risposta / per paginamax_tokens, max_tokens_per_page

​
Configurazione avanzata

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 di configurazione

Riferimento completo della configurazione, incluse le voci Plugin.