Providers
Perplexity
Il plugin Perplexity fornisce funzionalità di ricerca web tramite la Perplexity Search API o Perplexity Sonar tramite OpenRouter.
| Proprietà | Valore |
|---|---|
| Tipo | Provider di ricerca web (non un provider di modelli) |
| Auth | PERPLEXITY_API_KEY (diretta) o OPENROUTER_API_KEY (tramite OpenRouter) |
| Percorso config | plugins.entries.perplexity.config.webSearch.apiKey |
Installa il plugin
Installa il plugin ufficiale, quindi riavvia Gateway:
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartPer iniziare
Imposta la chiave API
Esegui il flusso interattivo di configurazione della ricerca web:
openclaw configure --section webOppure imposta direttamente la chiave:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"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:
API Perplexity nativa (pplx-)
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).
OpenRouter / Sonar (sk-or-)
Quando la tua chiave inizia con sk-or-, OpenClaw instrada tramite OpenRouter usando
il modello Perplexity Sonar. Questo trasporto restituisce risposte sintetizzate dall'IA con
citazioni.
| Prefisso chiave | Trasporto | Funzionalità |
|---|---|---|
pplx- |
Perplexity Search API nativa | Risultati strutturati, filtri dominio/lingua/data |
sk-or- |
OpenRouter (Sonar) | Risposte sintetizzate dall'IA con citazioni |
Filtri dell'API nativa
Quando si usa l'API Perplexity nativa, le ricerche supportano i seguenti filtri:
| Filtro | Descrizione | Esempio |
|---|---|---|
| Paese | Codice paese a 2 lettere | us, de, jp |
| Lingua | Codice lingua ISO 639-1 | en, fr, zh |
| Intervallo date | Finestra di attualità | day, week, month, year |
| Filtri dominio | Allowlist o denylist (max 20 domini) | example.com |
| Budget contenuti | Limiti di token per risposta / per pagina | max_tokens, max_tokens_per_page |
Configurazione avanzata
Variabile d'ambiente per processi daemon
Se OpenClaw Gateway viene eseguito come daemon (launchd/systemd), assicurati che
PERPLEXITY_API_KEY sia disponibile per quel processo.
Configurazione proxy OpenRouter
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.
