Tools

Búsqueda de Perplexity

OpenClaw admite Perplexity Search API 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 usas OPENROUTER_API_KEY, una clave sk-or-... en plugins.entries.perplexity.config.webSearch.apiKey, o defines plugins.entries.perplexity.config.webSearch.baseUrl / model, el proveedor cambia a la ruta de chat-completions y devuelve respuestas sintetizadas por IA con citas en lugar de resultados estructurados de Search API.

Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway:

bash

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Obtener una clave de API de Perplexity

Crea una cuenta de Perplexity en perplexity.ai/settings/api
Genera una clave de API en el panel
Guarda la clave en la configuración o define PERPLEXITY_API_KEY en el entorno de Gateway.

Compatibilidad con OpenRouter

Si ya usabas OpenRouter para Perplexity Sonar, conserva provider: "perplexity" y define OPENROUTER_API_KEY en el entorno de Gateway, o guarda 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

Perplexity Search API nativa

json5

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

Compatibilidad con OpenRouter / Sonar

json5

{  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 definir la clave

Mediante configuración: ejecuta openclaw configure --section web. Guarda la clave en ~/.openclaw/openclaw.json, dentro de plugins.entries.perplexity.config.webSearch.apiKey. Ese campo también acepta objetos SecretRef.

Mediante entorno: define PERPLEXITY_API_KEY u OPENROUTER_API_KEY en el entorno del proceso de Gateway. Para una instalación de gateway, colócala en ~/.openclaw/.env (o en el entorno de tu servicio). Consulta Variables de entorno.

Si provider: "perplexity" está configurado y la SecretRef de la clave de Perplexity no se puede resolver sin alternativa de entorno, el inicio o la recarga fallan rápidamente.

Parámetros de la herramienta

Estos parámetros se aplican a la ruta nativa de Perplexity Search API.

querystringrequired

Consulta de búsqueda.

countnumberdefault: 5

Número de resultados que devolver (1-10).

countrystring

Código de país ISO de 2 letras (por ejemplo, US, DE).

languagestring

Código de idioma ISO 639-1 (por ejemplo, en, de, fr).

freshness'day' | 'week' | 'month' | 'year'

Filtro de tiempo: day equivale a 24 horas.

date_afterstring

Solo resultados publicados después de esta fecha (YYYY-MM-DD).

date_beforestring

Solo resultados publicados antes de esta fecha (YYYY-MM-DD).

domain_filterstring[]

Arreglo de lista de dominios permitidos/bloqueados (máx. 20).

max_tokensnumberdefault: 25000

Presupuesto total de contenido (máx. 1000000).

max_tokens_per_pagenumberdefault: 2048

Límite de tokens por página.

Para la ruta heredada de compatibilidad con Sonar/OpenRouter:

Se aceptan query, count y freshness
Allí count es solo de compatibilidad; la respuesta sigue siendo una sola respuesta sintetizada con citas, no una lista de N resultados
Los filtros exclusivos de Search API, como country, language, date_after, date_before, domain_filter, max_tokens y max_tokens_per_page, devuelven errores explícitos

Ejemplos:

javascript

// Country and language-specific searchawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Recent results (past week)await web_search({  query: "AI news",  freshness: "week",}); // Date range searchawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domain filtering (allowlist)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Domain filtering (denylist - prefix with -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // More content extractionawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Reglas de filtro de dominios

Máximo 20 dominios por filtro
No se puede mezclar la lista de permitidos y la lista de bloqueados en la misma solicitud
Usa el prefijo - para las entradas de la lista de bloqueados (por ejemplo, ["-reddit.com"])

Notas

Perplexity Search API devuelve resultados estructurados de búsqueda web (title, url, snippet)
OpenRouter o plugins.entries.perplexity.config.webSearch.baseUrl / model explícitos hacen que Perplexity vuelva a usar chat completions de Sonar por compatibilidad
La compatibilidad con Sonar/OpenRouter devuelve una sola respuesta sintetizada con citas, no filas de resultados estructuradas
Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (configurable mediante cacheTtlMinutes)

Relacionado

Web search overview

Todos los proveedores y reglas de detección automática.

Brave search

Resultados estructurados con filtros de país e idioma.

Exa search

Búsqueda neuronal con extracción de contenido.

Perplexity Search API docs

Inicio rápido y referencia oficiales de Perplexity Search API.

Was this useful?