Skip to main content
El plugin de Perplexity registra un proveedor web_search con dos transportes: la API nativa de búsqueda de Perplexity (resultados estructurados con filtros) y las completaciones de chat de Perplexity Sonar, directamente o mediante OpenRouter (respuestas sintetizadas por IA con citas).
Esta página explica la configuración del proveedor Perplexity. Para consultar la herramienta Perplexity (cómo la utiliza el agente), véase Búsqueda con Perplexity.

​
Instalar el plugin

​
Primeros pasos

1

Establecer la clave de API

También se puede establecer la clave directamente:
También funciona una clave exportada como PERPLEXITY_API_KEY o OPENROUTER_API_KEY en el entorno del Gateway.
2

Empezar a buscar

web_search detecta automáticamente Perplexity cuando su clave es la credencial de búsqueda disponible; no se requiere ninguna configuración adicional. Para fijar el proveedor explícitamente:

​
Modos de búsqueda

El plugin resuelve el transporte en este orden:
  1. webSearch.baseUrl o webSearch.model establecido: siempre enruta mediante las completaciones de chat de Sonar hacia ese punto de conexión, independientemente del tipo de clave.
  2. En caso contrario, el origen de la clave determina el punto de conexión: el prefijo de una clave configurada selecciona el transporte (la configuración prevalece sobre las variables de entorno); una clave de entorno utiliza directamente su punto de conexión correspondiente.
Una clave configurada con cualquier otro prefijo también utiliza la API nativa de búsqueda. La ruta de completaciones de chat utiliza de forma predeterminada el modelo perplexity/sonar-pro; se puede sustituir con plugins.entries.perplexity.config.webSearch.model.

​
Filtrado de la API nativa

Los filtros exclusivos del transporte nativo devuelven un error descriptivo en la ruta de completaciones de chat. freshness no se puede combinar con date_after/date_before.

​
Configuración avanzada

Una clave exportada únicamente en un shell interactivo no es visible para un demonio del Gateway de launchd/systemd, a menos que ese entorno se importe explícitamente. Establezca la clave en ~/.openclaw/.env o mediante env.shellEnv para que el proceso del Gateway pueda leerla. Véase Variables de entorno para consultar el orden de precedencia completo.
Para enrutar las búsquedas de Perplexity mediante OpenRouter, establezca una OPENROUTER_API_KEY (prefijo sk-or-) en lugar de una clave nativa de Perplexity. OpenClaw detecta la clave y cambia automáticamente al transporte Sonar. Resulta útil si ya se ha configurado la facturación de OpenRouter y se desea consolidar allí los proveedores.

​
Contenido relacionado

Herramienta de búsqueda de Perplexity

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

Referencia de configuración

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