Perplexity

El complemento Perplexity proporciona capacidades de búsqueda web a través de la API de búsqueda de Perplexity o Perplexity Sonar a través de OpenRouter.

Note

Esta página es la configuración del

proveedor

de Perplexity. Para la

herramienta

de Perplexity (cómo la usa el agente), consulte

Herramienta de Perplexity

.

Propiedad	Valor
Tipo	Proveedor de búsqueda web (no un proveedor de modelos)
Autenticación	PERPLEXITY_API_KEY (directo) o OPENROUTER_API_KEY (vía OpenRouter)
Ruta de configuración	plugins.entries.perplexity.config.webSearch.apiKey

Para empezar

1. Establecer la clave API

   Ejecute el flujo de configuración interactivo de búsqueda web:

   openclaw configure --section web

   O establezca la clave directamente:

   openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

2. Comenzar a buscar

   Una vez configurada la clave, el agente utilizará automáticamente Perplexity para búsquedas web. No se requieren pasos adicionales.

Modos de búsqueda

El complemento selecciona automáticamente el transporte según el prefijo de la clave API:

API nativa de Perplexity (pplx-)OpenRouter / Sonar (sk-or-)

Cuando su clave comienza con pplx-, OpenClaw utiliza la API de búsqueda nativa de Perplexity. Este transporte devuelve resultados estructurados y admite filtros de dominio, idioma y fecha (consulte las opciones de filtrado a continuación).

Cuando su clave comienza con sk-or-, OpenClaw enruta a través de OpenRouter usando el modelo Perplexity Sonar. Este transporte devuelve respuestas sintetizadas por IA con citas.

Prefijo de clave	Transporte	Características
pplx-	API de búsqueda nativa de Perplexity	Resultados estructurados, filtros de dominio/idioma/fecha
sk-or-	OpenRouter (Sonar)	Respuestas sintetizadas por IA con citas

Filtrado de API nativa

Note

Las opciones de filtrado solo están disponibles cuando se utiliza 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:

Filtro	Descripción	Ejemplo
País	Código de país de dos letras	us, de, jp
Idioma	Código de idioma ISO 639-1	en, fr, zh
Rango de fechas	Ventana de recencia	day, week, month, year
Filtros de dominio	Lista de permitidos o lista de bloqueados (máximo 20 dominios)	example.com
Presupuesto de contenido	Límites de tokens por respuesta / por página	max_tokens, max_tokens_per_page

Configuración avanzada

Variable de entorno para procesos demonio

Si OpenClaw Gateway se ejecuta como un demonio (launchd/systemd), asegúrese de que PERPLEXITY_API_KEY esté disponible para ese proceso.

Warning

Una clave exportada solo en un shell interactivo no será visible para un demonio launchd/systemd a menos que ese entorno se importe explícitamente. Establezca la clave en ~/.openclaw/.env o a través de env.shellEnv para garantizar que el proceso de la puerta de enlace pueda leerla.

Configuración del proxy OpenRouter

Si prefiere enrutar las búsquedas de Perplexity a través de OpenRouter, establezca 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.

Tip

El transporte OpenRouter es útil si ya tiene una cuenta de OpenRouter y desea una facturación consolidada para varios proveedores.

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 del complemento.