Configura Perplexity Sonar en OpenClaw

Seguro te ha pasado: tu agente de IA se queda corto porque no puede acceder a información en tiempo real. Tener que buscar datos manualmente en el navegador para pegarlos en el prompt es una pérdida de tiempo que rompe tu flujo de trabajo. Necesitas que tu herramienta de búsqueda sea rápida y devuelva resultados actuales sin complicaciones.

Para solucionar esto, te recomiendo usar Perplexity Sonar. Es la mejor opción para que la herramienta web_search de OpenClaw obtenga datos frescos de internet de forma automática.

Requisitos previos

• Una API Key de Perplexity (PERPLEXITY_API_KEY).
• O una API Key de OpenRouter (OPENROUTER_API_KEY).

Inicio rápido

Configura el buscador en 5 minutos siguiendo estos pasos. Solo tienes que actualizar tu archivo de configuración con los datos de tu proveedor.

Ejemplo de configuración

Si quieres usar la API directa de Perplexity con el modelo Pro, usa este bloque de código:

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

Opciones de API

Tienes dos rutas para conectar el servicio:

1. Perplexity (directo): Usa la Base URL https://api.perplexity.ai y la variable de entorno PERPLEXITY_API_KEY.
2. OpenRouter (alternativa): Usa la Base URL https://openrouter.ai/api/v1 y la variable OPENROUTER_API_KEY. Es ideal si usas créditos prepagados o cripto.

Modelos disponibles

Puedes elegir entre estos modelos según tu necesidad:

• perplexity/sonar: Q&A rápido con búsqueda web.
• perplexity/sonar-pro (predeterminado): Razonamiento multi-paso con búsqueda web.
• perplexity/sonar-reasoning-pro: Investigación profunda.

Cómo cambiar desde Brave

Si ya usabas Brave y quieres pasar a Perplexity, actualiza tu configuración así:

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
        },
      },
    },
  },
}

Solución de problemas

Conflicto de API Keys Si tienes configuradas tanto PERPLEXITY_API_KEY como OPENROUTER_API_KEY al mismo tiempo, OpenClaw podría no saber cuál usar. Para evitar errores, define explícitamente tools.web.search.perplexity.baseUrl o tools.web.search.perplexity.apiKey en tu archivo de configuración.

Detección automática de Base URL Si no defines una URL base, OpenClaw decidirá por ti basándose en el formato de la key:

• Keys que empiezan con pplx-... usan Perplexity directo.
• Keys que empiezan con sk-or-... usan OpenRouter.
• Formatos desconocidos usan OpenRouter como fallback seguro.

¿Necesitas ayuda con los pasos anteriores? Prueba el AI Setup Assistant.

Próximos pasos

• Web tools