Búsqueda de Perplexity

OpenClaw admite la API de búsqueda de Perplexity como proveedor de web_search. Devuelve resultados estructurados con los campos title, url y snippet.

Por compatibilidad, OpenClaw también admite configuraciones heredadas de Perplexity Sonar/OpenRouter. Si usa OPENROUTER_API_KEY, una clave sk-or-... en plugins.entries.perplexity.config.webSearch.apiKey, o establece plugins.entries.perplexity.config.webSearch.baseUrl / model, el proveedor cambia a la ruta de finalización de chat y devuelve respuestas sintetizadas por IA con citas en lugar de resultados estructurados de la API de búsqueda.

Instalar el Plugin

Instale el Plugin oficial y, a continuación, reinicie el Gateway:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Obtener una clave de API de Perplexity

1. Cree una cuenta de Perplexity en perplexity.ai/settings/api.
2. Genere una clave de API en el panel.
3. Guarde la clave en la configuración o establezca PERPLEXITY_API_KEY en el entorno del Gateway.

Compatibilidad con OpenRouter

Si ya usaba OpenRouter para Perplexity Sonar, mantenga provider: "perplexity" y establezca OPENROUTER_API_KEY en el entorno del Gateway, o guarde una clave sk-or-... en plugins.entries.perplexity.config.webSearch.apiKey.

Controles de compatibilidad opcionales:

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

Ejemplos de configuración

API de búsqueda nativa de Perplexity

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "pplx-...",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

Compatibilidad con OpenRouter / Sonar

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "<openrouter-api-key>",            baseUrl: "https://openrouter.ai/api/v1",            model: "perplexity/sonar-pro",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

Dónde establecer la clave

Mediante la configuración: ejecute openclaw configure --section web. La clave se guarda en ~/.openclaw/openclaw.json, en plugins.entries.perplexity.config.webSearch.apiKey. Ese campo también admite objetos SecretRef.

Mediante el entorno: establezca PERPLEXITY_API_KEY u OPENROUTER_API_KEY en el entorno del proceso del Gateway. Para una instalación del Gateway, inclúyala en ~/.openclaw/.env (o en el entorno de su servicio). Consulte Variables de entorno.

Si se configura provider: "perplexity" y la referencia SecretRef de la clave de Perplexity no se resuelve ni existe una alternativa en el entorno, el inicio o la recarga fallan de inmediato.

Parámetros de la herramienta

Estos parámetros se aplican a la ruta de la API de búsqueda nativa de Perplexity.

Para la ruta de compatibilidad heredada con Sonar/OpenRouter:

• Se aceptan query, count y freshness.
• En esta ruta, count solo se admite por compatibilidad; la respuesta sigue siendo una única respuesta sintetizada con citas, en lugar de una lista de N resultados.
• Los filtros exclusivos de la API de búsqueda (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) devuelven errores explícitos.

Ejemplos:

// Búsqueda específica por país e idiomaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Resultados recientes (última semana)await web_search({  query: "AI news",  freshness: "week",}); // Búsqueda por intervalo de fechasawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Filtrado por dominio (lista de permitidos)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Filtrado por dominio (lista de denegados: use el prefijo -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Extracción de más contenidoawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Reglas del filtro de dominios

• Máximo de 20 dominios por filtro.
• No se pueden combinar entradas de la lista de permitidos y de la lista de denegados en una misma solicitud.
• Use el prefijo - para las entradas de la lista de denegados (p. ej., ["-reddit.com"]).

Notas

• La API de búsqueda de Perplexity devuelve resultados estructurados de búsqueda web (title, url, snippet).
• OpenRouter, o un valor explícito de plugins.entries.perplexity.config.webSearch.baseUrl / model, hace que Perplexity vuelva a usar las finalizaciones de chat de Sonar por compatibilidad.
• La compatibilidad con Sonar/OpenRouter devuelve una única respuesta sintetizada con citas, no filas de resultados estructurados.
• Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (se puede configurar mediante cacheTtlMinutes).

Contenido relacionado