Saltar al contenido principal

​
Perplexity (proveedor de búsqueda web)

El Plugin de Perplexity proporciona capacidades de búsqueda web mediante la API de búsqueda de Perplexity o Perplexity Sonar a través de OpenRouter.
Esta página cubre la configuración del proveedor de Perplexity. Para la herramienta de Perplexity (cómo la usa el agente), consulta Perplexity tool.
PropiedadValor
TipoProveedor de búsqueda web (no proveedor de modelos)
AutenticaciónPERPLEXITY_API_KEY (directo) o OPENROUTER_API_KEY (mediante OpenRouter)
Ruta de configuraciónplugins.entries.perplexity.config.webSearch.apiKey

​
Primeros pasos

1

Set the API key

Ejecuta el flujo interactivo de configuración de búsqueda web:
openclaw configure --section web
O establece la clave directamente:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Start searching

El agente usará automáticamente Perplexity para las búsquedas web una vez configurada la clave. No se requieren pasos adicionales.

​
Modos de búsqueda

El Plugin selecciona automáticamente el transporte según el prefijo de la clave de API:
Cuando tu clave comienza por pplx-, OpenClaw usa la API de búsqueda nativa de Perplexity. Este transporte devuelve resultados estructurados y admite filtros de dominio, idioma y fecha (consulta las opciones de filtrado más abajo).
Prefijo de claveTransporteFunciones
pplx-API de búsqueda nativa de PerplexityResultados estructurados, filtros de dominio/idioma/fecha
sk-or-OpenRouter (Sonar)Respuestas sintetizadas por IA con citas

​
Filtrado de la API nativa

Las opciones de filtrado solo están disponibles al usar la API nativa de Perplexity (pplx-). Las búsquedas con OpenRouter/Sonar no admiten estos parámetros.
Al usar la API nativa de Perplexity, las búsquedas admiten los siguientes filtros:
FiltroDescripciónEjemplo
PaísCódigo de país de 2 letrasus, de, jp
IdiomaCódigo de idioma ISO 639-1en, fr, zh
Rango de fechasVentana de antigüedadday, week, month, year
Filtros de dominioAllowlist o denylist (máximo 20 dominios)example.com
Presupuesto de contenidoLímites de tokens por respuesta / por páginamax_tokens, max_tokens_per_page

​
Notas avanzadas

Si OpenClaw Gateway se ejecuta como daemon (launchd/systemd), asegúrate de que PERPLEXITY_API_KEY esté disponible para ese proceso.
Una clave establecida solo en ~/.profile no será visible para un daemon de launchd/systemd a menos que ese entorno se importe explícitamente. Establece la clave en ~/.openclaw/.env o mediante env.shellEnv para asegurarte de que el proceso de gateway pueda leerla.
Si prefieres enrutar las búsquedas de Perplexity a través de OpenRouter, establece OPENROUTER_API_KEY (prefijo sk-or-) en lugar de una clave nativa de Perplexity. OpenClaw detectará el prefijo y cambiará automáticamente al transporte Sonar.
El transporte de OpenRouter es útil si ya tienes una cuenta de OpenRouter y quieres facturación consolidada entre varios proveedores.

​
Relacionado

Perplexity search tool

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

Configuration reference

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