Búsqueda de Perplexity

​

Instalar el plugin

openclaw plugins install @openclaw/perplexity-plugin
openclaw 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

• 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

​

Parámetros de la herramienta

• Se aceptan query, count y freshness.
• count solo se admite por compatibilidad en esa ruta; 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.

// Búsqueda específica por país e idioma
await web_search({
  query: "energía renovable",
  country: "DE",
  language: "de",
});

// Resultados recientes (última semana)
await web_search({
  query: "noticias sobre IA",
  freshness: "week",
});

// Búsqueda por intervalo de fechas
await web_search({
  query: "avances en IA",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Filtrado de dominios (lista de permitidos)
await web_search({
  query: "investigación climática",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Filtrado de dominios (lista de denegados: usar el prefijo -)
await web_search({
  query: "reseñas de productos",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Extracción de más contenido
await web_search({
  query: "investigación detallada sobre IA",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Reglas del filtro de dominios

• Máximo de 20 dominios por filtro.
• No se pueden mezclar entradas de la lista de permitidos y de la lista de denegados en la 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, vuelve a cambiar Perplexity a 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 (configurable mediante cacheTtlMinutes).

​

Contenido relacionado