docs/docs/es/perplexity.md

read_when	summary	title	x-i18n
Quieres usar Perplexity Search para búsquedas web Necesitas configurar `PERPLEXITY_API_KEY` o `OPENROUTER_API_KEY`	API de búsqueda de Perplexity y compatibilidad con Sonar/OpenRouter para `web_search`	Búsqueda de Perplexity (ruta heredada)	generated_at model provider source_hash source_path workflow 2026-04-24T05:37:19Z gpt-5.4 openai 87a7b6e14f636cfe6b7c5833af1b0aecb334a39babbb779c32f29bbbb5c9e14a perplexity.md 15

API de 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 usas OPENROUTER_API_KEY, una clave sk-or-... en plugins.entries.perplexity.config.webSearch.apiKey, o estableces 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 búsqueda.

Obtener una clave de API de Perplexity

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

Compatibilidad con OpenRouter

Si ya estabas usando OpenRouter para Perplexity Sonar, mantén provider: "perplexity" y establece OPENROUTER_API_KEY en el entorno del Gateway, o guarda una clave sk-or-... en plugins.entries.perplexity.config.webSearch.apiKey.

Controles opcionales de compatibilidad:

• 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 configuración: ejecuta openclaw configure --section web. Guarda la clave en ~/.openclaw/openclaw.json bajo plugins.entries.perplexity.config.webSearch.apiKey. Ese campo también acepta objetos SecretRef.

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

Si provider: "perplexity" está configurado y el SecretRef de la clave de Perplexity no se resuelve sin alternativa del entorno, el arranque/la recarga fallan de inmediato.

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 (YYYY-MM-DD)
date_before	Solo resultados publicados antes de esta fecha (YYYY-MM-DD)
domain_filter	Array de lista de permitidos/lista de 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 heredada de compatibilidad Sonar/OpenRouter:

• se aceptan query, count y freshness
• count es solo por compatibilidad allí; 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 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 domain_filter

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

Notas

• La API de búsqueda de Perplexity 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 Sonar chat completions por compatibilidad
• La compatibilidad 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)

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

Relacionado

• Búsqueda de Perplexity
• Búsqueda web