Búsqueda de Perplexity (ruta heredada)

API de Perplexity Search

OpenClaw es compatible con la API de Perplexity Search como proveedor web_search. Devuelve resultados estructurados con los campos title, url y snippet.

Para mayor compatibilidad, OpenClaw también admite configuraciones heredadas de Perplexity Sonar/OpenRouter. Si utiliza 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 chat-completions y devuelve respuestas sintetizadas por IA con citas en lugar de resultados estructurados de la API de Search.

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 de control
3. Guarde la clave en la configuración o establezca PERPLEXITY_API_KEY en el entorno del Gateway.

Compatibilidad con OpenRouter

Si ya estaba utilizando OpenRouter para Perplexity Sonar, mantenga provider: "perplexity" y establezca OPENROUTER_API_KEY en el entorno de Gateway, o almacene 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 nativa de Perplexity Search

{
  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

A través de la configuración: ejecute openclaw configure --section web. Almacena la clave en ~/.openclaw/openclaw.json bajo plugins.entries.perplexity.config.webSearch.apiKey. Ese campo también acepta objetos SecretRef.

Vía entorno: establezca PERPLEXITY_API_KEY o OPENROUTER_API_KEY en el entorno de proceso de Gateway. Para una instalación de puerta de enlace, póngalo en ~/.openclaw/.env (o en su entorno de servicio). Consulte Env vars.

Si provider: "perplexity" está configurado y el SecretRef de la clave de Perplexidad no está resuelto sin un respaldo de entorno, el inicio/recarga falla rápidamente.

Parámetros de la herramienta

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

Parámetro	Descripción
query	Consulta de búsqueda (obligatorio)
count	Número de resultados a devolver (1-10, predeterminado: 5)
country	Código de país ISO de 2 letras (por ejemplo, “US”, “DE”)
language	Código de idioma ISO 639-1 (por ejemplo, “en”, “de”, “fr”)
freshness	Filtro de tiempo: day (24h), week, month o year
date_after	Solo resultados publicados después de esta fecha (AAAA-MM-DD)
date_before	Solo resultados publicados antes de esta fecha (AAAA-MM-DD)
domain_filter	Matriz de lista de permitidos/bloqueados de dominios (máx. 20)
max_tokens	Presupuesto total de contenido (predeterminado: 25000, máx: 1000000)
max_tokens_per_page	Límite de tokens por página (predeterminado: 2048)

Para la ruta de compatibilidad heredada de Sonar/OpenRouter, solo se admiten query y freshness. Los filtros exclusivos de la API de búsqueda, como country, language, date_after, date_before, domain_filter, max_tokens y max_tokens_per_page, devuelven errores explícitos.

Ejemplos:

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await 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 extraction
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

Reglas de filtro de dominio

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

Notas

• La API de búsqueda de Perplexity devuelve resultados de búsqueda web estructurados (title, url, snippet)
• OpenRouter o plugins.entries.perplexity.config.webSearch.baseUrl / model explícitos cambia Perplexity de nuevo a completaciones de chat Sonar para mayor compatibilidad
• Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (configurable mediante cacheTtlMinutes)

Consulte Herramientas web para ver la configuración completa de web_search. Consulte Documentación de la API de búsqueda de Perplexity para más detalles.