Saltar al contenido principal
El Plugin de Perplexity registra un proveedor web_search con dos transportes: la API nativa de Perplexity Search (resultados estructurados con filtros) y las finalizaciones de chat de Perplexity Sonar, directas o mediante OpenRouter (respuestas sintetizadas por IA con citas).
Esta página cubre la configuración del proveedor de Perplexity. Para la herramienta de Perplexity (cómo la usa el agente), consulta búsqueda de Perplexity.
PropiedadValor
TipoProveedor de búsqueda web (no un proveedor de modelos)
AuthPERPLEXITY_API_KEY (nativo) o OPENROUTER_API_KEY (mediante OpenRouter)
Ruta de configuraciónplugins.entries.perplexity.config.webSearch.apiKey
Sobrescriturasplugins.entries.perplexity.config.webSearch.baseUrl / .model
Obtener una claveperplexity.ai/settings/api

​
Instalar Plugin

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Primeros pasos

1

Configurar la clave de API

openclaw configure --section web
O configura la clave directamente:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
Una clave exportada como PERPLEXITY_API_KEY u OPENROUTER_API_KEY en el entorno del Gateway también funciona.
2

Empezar a buscar

web_search detecta automáticamente Perplexity cuando su clave es la credencial de búsqueda disponible; no se requiere más configuración. Para fijar el proveedor explícitamente:
openclaw config set tools.web.search.provider perplexity

​
Modos de búsqueda

El Plugin resuelve el transporte en este orden:
  1. webSearch.baseUrl o webSearch.model configurado: siempre enruta mediante finalizaciones de chat de Sonar contra ese endpoint, independientemente del tipo de clave.
  2. De lo contrario, el origen de la clave decide el endpoint: el prefijo de una clave configurada elige el transporte (la configuración tiene prioridad sobre las variables de entorno); una clave de entorno usa directamente su endpoint correspondiente.
Prefijo de claveTransporteFunciones
pplx-API nativa de Perplexity Search (https://api.perplexity.ai)Resultados estructurados, filtros de dominio/idioma/fecha
sk-or-OpenRouter (https://openrouter.ai/api/v1), modelo SonarRespuestas sintetizadas por IA con citas
Una clave configurada con cualquier otro prefijo también usa la API nativa de Search. La ruta de finalizaciones de chat usa de forma predeterminada el modelo perplexity/sonar-pro; sobrescríbelo con plugins.entries.perplexity.config.webSearch.model.

​
Filtrado de la API nativa

FiltroDescripciónTransporte
countResultados por búsqueda, 1-10 (predeterminado 5)Solo nativo
freshnessVentana de antigüedad: day, week, month, yearAmbos
countryCódigo de país de 2 letras (us, de, jp)Solo nativo
languageCódigo de idioma ISO 639-1 (en, fr, zh)Solo nativo
date_after / date_beforeRango de fecha de publicación en YYYY-MM-DDSolo nativo
domain_filterMáx. 20 dominios; lista de permitidos o lista de denegados con prefijo -, nunca mezcladasSolo nativo
max_tokens / max_tokens_per_pagePresupuesto de contenido en todos los resultados / por páginaSolo nativo
Los filtros solo nativos devuelven un error descriptivo en la ruta de finalizaciones de chat. freshness no se puede combinar con date_after/date_before.

​
Configuración avanzada

Una clave exportada solo en una shell interactiva no es visible para un daemon de Gateway de launchd/systemd a menos que ese entorno se importe explícitamente. Configura la clave en ~/.openclaw/.env o mediante env.shellEnv para que el proceso de Gateway pueda leerla. Consulta Variables de entorno para ver el orden de precedencia completo.
Para enrutar búsquedas de Perplexity mediante OpenRouter, configura una OPENROUTER_API_KEY (prefijo sk-or-) en lugar de una clave nativa de Perplexity. OpenClaw detecta la clave y cambia al transporte Sonar automáticamente. Es útil si ya tienes configurada la facturación de OpenRouter y quieres consolidar proveedores allí.

​
Relacionado

Herramienta de búsqueda de Perplexity

Cómo el agente invoca búsquedas de Perplexity e interpreta los resultados.

Referencia de configuración

Referencia de configuración completa, incluidas las entradas de Plugin.