OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Perplexity

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

Propiedad Valor
Tipo Proveedor de búsqueda web (no es un proveedor de modelos)
Autenticación PERPLEXITY_API_KEY (nativa) o OPENROUTER_API_KEY (mediante OpenRouter)
Ruta de configuración plugins.entries.perplexity.config.webSearch.apiKey
Sustituciones plugins.entries.perplexity.config.webSearch.baseUrl / .model
Obtener una clave perplexity.ai/settings/api

Instalar el plugin

bash
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Primeros pasos

  • Establecer la clave de API

    bash
    openclaw configure --section web

    También se puede establecer la clave directamente:

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

    También funciona una clave exportada como PERPLEXITY_API_KEY o OPENROUTER_API_KEY en el entorno del Gateway.

  • 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:

    bash
    openclaw config set tools.web.search.provider perplexity

    • 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.
    Prefijo de clave Transporte Funciones
    pplx- API nativa de búsqueda de Perplexity (https://api.perplexity.ai) Resultados estructurados y filtros por dominio, idioma y fecha
    sk-or- OpenRouter (https://openrouter.ai/api/v1), modelo Sonar Respuestas sintetizadas por IA con citas

    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

    Filtro Descripción Transporte
    count Resultados por búsqueda, 1-10 (valor predeterminado: 5) Solo nativo
    freshness Intervalo de actualidad: day, week, month, year Ambos
    country Código de país de 2 letras (us, de, jp) Solo nativo
    language Código de idioma ISO 639-1 (en, fr, zh) Solo nativo
    date_after / date_before Intervalo de fechas de publicación en YYYY-MM-DD Solo nativo
    domain_filter Máximo de 20 dominios; lista de permitidos o lista de denegados con el prefijo -, sin combinarlas nunca Solo nativo
    max_tokens / max_tokens_per_page Presupuesto de contenido para todos los resultados/por página Solo nativo

    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

    Variable de entorno para procesos demonio
    Configuración del proxy de OpenRouter

    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.
    Was this useful?
    On this page

    On this page