Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

El Plugin 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 es la configuración del proveedor de Perplexity. Para la herramienta de Perplexity (cómo la usa el agente), consulta herramienta de Perplexity.
PropiedadValor
TipoProveedor de búsqueda web (no un proveedor de modelos)
AutenticaciónPERPLEXITY_API_KEY (directa) o OPENROUTER_API_KEY (vía OpenRouter)
Ruta de configuraciónplugins.entries.perplexity.config.webSearch.apiKey

​
Primeros pasos

1

Configurar la clave de API

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

Empezar a buscar

El agente usará automáticamente Perplexity para las búsquedas web una vez que la clave esté configurada. 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 empieza por pplx-, OpenClaw usa la API nativa de búsqueda 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 nativa de Perplexity SearchResultados 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 (clave pplx-). Las búsquedas de 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
Intervalo de fechasVentana de actualidadday, week, month, year
Filtros de dominioLista de permitidos o bloqueados (máx. 20 dominios)example.com
Presupuesto de contenidoLímites de tokens por respuesta / por páginamax_tokens, max_tokens_per_page

​
Configuración avanzada

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

​
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.