Providers
Perplexity
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.
| Propiedad | Valor |
|---|---|
| Tipo | Proveedor de búsqueda web (no un proveedor de modelos) |
| Autenticación | PERPLEXITY_API_KEY (directa) o OPENROUTER_API_KEY (vía OpenRouter) |
| Ruta de configuración | plugins.entries.perplexity.config.webSearch.apiKey |
Instalar Plugin
Instala el Plugin oficial y luego reinicia Gateway:
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartPrimeros pasos
Configura la clave de API
Ejecuta el flujo interactivo de configuración de búsqueda web:
openclaw configure --section webO configura la clave directamente:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Empieza a buscar
El agente usará Perplexity automáticamente para 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:
API nativa de Perplexity (pplx-)
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 a continuación).
OpenRouter / Sonar (sk-or-)
Cuando tu clave empieza por 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 | Funciones |
|---|---|---|
pplx- |
API nativa de búsqueda Perplexity | Resultados estructurados, filtros de dominio/idioma/fecha |
sk-or- |
OpenRouter (Sonar) | Respuestas sintetizadas por IA con citas |
Filtrado de la API nativa
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 2 letras | us, de, jp |
| Idioma | Código de idioma ISO 639-1 | en, fr, zh |
| Intervalo de fechas | Ventana de actualidad | day, week, month, year |
| Filtros de dominio | Lista de permitidos o denegados (máx. 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 demonio (launchd/systemd), asegúrate de que PERPLEXITY_API_KEY esté disponible para ese proceso.
Configuración del proxy de OpenRouter
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á automáticamente al transporte Sonar.
