Providers
Perplexity
Il plugin Perplexity registra un provider web_search con due modalità di trasporto: l'API nativa Perplexity Search (risultati strutturati con filtri) e i completamenti chat Perplexity Sonar, direttamente o tramite OpenRouter (risposte sintetizzate dall'IA con citazioni).
| Proprietà | Valore |
|---|---|
| Tipo | Provider di ricerca web (non un provider di modelli) |
| Autenticazione | PERPLEXITY_API_KEY (nativa) o OPENROUTER_API_KEY (tramite OpenRouter) |
| Percorso configurazione | plugins.entries.perplexity.config.webSearch.apiKey |
| Sostituzioni | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| Ottieni una chiave | perplexity.ai/settings/api |
Installare il plugin
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartPer iniziare
Imposta la chiave API
openclaw configure --section webIn alternativa, imposta direttamente la chiave:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Funziona anche una chiave esportata come PERPLEXITY_API_KEY o OPENROUTER_API_KEY nell'ambiente del Gateway.
Inizia a cercare
web_search rileva automaticamente Perplexity quando la relativa chiave è la credenziale di ricerca disponibile; non è necessaria alcuna configurazione aggiuntiva. Per specificare esplicitamente il provider:
openclaw config set tools.web.search.provider perplexityModalità di ricerca
Il plugin determina la modalità di trasporto nel seguente ordine:
- Se
webSearch.baseUrlowebSearch.modelè impostato, instrada sempre la richiesta tramite i completamenti chat Sonar verso tale endpoint, indipendentemente dal tipo di chiave. - In caso contrario, l'origine della chiave determina l'endpoint: il prefisso di una chiave configurata seleziona la modalità di trasporto (la configurazione ha la precedenza sulle variabili d'ambiente); una chiave d'ambiente utilizza direttamente l'endpoint corrispondente.
| Prefisso chiave | Modalità di trasporto | Funzionalità |
|---|---|---|
pplx- |
API nativa Perplexity Search (https://api.perplexity.ai) |
Risultati strutturati, filtri per dominio/lingua/data |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1), modello Sonar |
Risposte sintetizzate dall'IA con citazioni |
Una chiave configurata con qualsiasi altro prefisso utilizza anch'essa l'API Search nativa. Il percorso dei completamenti chat utilizza per impostazione predefinita il modello perplexity/sonar-pro; puoi sostituirlo con plugins.entries.perplexity.config.webSearch.model.
Filtri dell'API nativa
| Filtro | Descrizione | Modalità di trasporto |
|---|---|---|
count |
Risultati per ricerca, 1-10 (valore predefinito: 5) | Solo nativa |
freshness |
Intervallo di aggiornamento: day, week, month, year |
Entrambe |
country |
Codice paese di 2 lettere (us, de, jp) |
Solo nativa |
language |
Codice lingua ISO 639-1 (en, fr, zh) |
Solo nativa |
date_after / date_before |
Intervallo delle date di pubblicazione nel formato YYYY-MM-DD |
Solo nativa |
domain_filter |
Massimo 20 domini; elenco consentito o elenco negato con prefisso -, mai combinati |
Solo nativa |
max_tokens / max_tokens_per_page |
Budget dei contenuti per tutti i risultati / per pagina | Solo nativa |
I filtri disponibili solo per l'API nativa restituiscono un errore descrittivo nel percorso dei completamenti chat. freshness non può essere combinato con date_after/date_before.
Configurazione avanzata
Variabile d'ambiente per i processi daemon
Configurazione del proxy OpenRouter
Per instradare le ricerche Perplexity tramite OpenRouter, imposta una OPENROUTER_API_KEY (prefisso sk-or-) anziché una chiave Perplexity nativa. OpenClaw rileva la chiave e passa automaticamente alla modalità di trasporto Sonar. È utile se hai già configurato la fatturazione di OpenRouter e desideri consolidare lì i provider.
