Zalo ClawBot

OpenClaw se conecta a Zalo ClawBot mediante el Plugin externo @zalo-platforms/openclaw-zaloclawbot incluido en el catálogo. El inicio de sesión usa un código QR de Zalo Mini App.

Compatibilidad

Requisitos previos

• Node.js >= 22
• OpenClaw debe estar instalado (CLI openclaw disponible).
• Una cuenta de Zalo en un dispositivo móvil para escanear el código QR de inicio de sesión.

Instalar con onboard (recomendado)

Ejecuta el asistente de incorporación de OpenClaw y elige Zalo ClawBot en el menú de canales:

openclaw onboard

El asistente instala el Plugin desde el catálogo oficial (con integridad verificada), muestra el QR de inicio de sesión directamente en la terminal y finaliza la configuración del canal cuando lo escaneas con la app de Zalo. No se necesitan comandos adicionales.

Instalación manual

Para agregar el canal a un Gateway ya incorporado, sigue estos pasos:

1. Instala el Plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

Usa la versión exacta fijada que se muestra arriba (coincide con la entrada del catálogo oficial), para que OpenClaw verifique el paquete contra el hash de integridad del catálogo durante la instalación.

2. Habilita el Plugin en la configuración

openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true

3. Genera el código QR e inicia sesión

openclaw channels login --channel openclaw-zaloclawbot

Escanea el código QR mostrado en la terminal con la app móvil de Zalo, acepta los Términos de uso dentro de Zalo Mini App y autoriza la sesión.

4. Reinicia el Gateway

openclaw gateway restart

Cómo funciona

A diferencia del canal estándar de desarrollador de Zalo, que requiere registrar tu propia Zalo Official Account (OA) y pegar credenciales estáticas de desarrollador, Zalo ClawBot funciona como un asistente personal vinculado al propietario usando una infraestructura oficial compartida:

1. Incorporación segura: El código QR resuelve a una Zalo Mini App segura que vincula un bot privado recién aprovisionado bajo una OA oficial compartida directamente a tu ID de usuario de Zalo.
2. Privacidad vinculada al propietario: Por diseño, el bot está restringido a comunicarse solo con su propietario. Los mensajes de otros usuarios se descartan a nivel de plataforma, lo que hace que la conexión sea privada y segura.
3. Ruta de API oficial: El Plugin usa las API de Zalo Bot Platform en lugar de automatización de navegador o de sesión web.

Funcionamiento interno

El Plugin Zalo ClawBot se comunica con las API de Zalo mediante un bucle persistente de mensajes con sondeo largo. Para mantener un entorno de ejecución limpio y ligero:

• Las conexiones de sondeo largo utilizan el endpoint getUpdates.
• Los Webhooks están deshabilitados de forma predeterminada para ejecuciones locales de Gateway en escritorio/terminal.
• Los mensajes se procesan del lado del cliente y se asignan directamente al entorno de ejecución de tu agente local.

El Plugin externo administra las credenciales del bot dentro del directorio de estado de OpenClaw. Trata ese directorio como confidencial e inclúyelo en la misma política de control de acceso y copias de seguridad que el resto de tu estado de OpenClaw.

Solución de problemas

• Tiempo de espera agotado del inicio de sesión con QR: El token de inicio de sesión (zbsk) caduca después de 5 minutos por motivos de seguridad. Si el código QR caduca antes de que lo escanees, simplemente vuelve a ejecutar el comando de inicio de sesión para generar uno nuevo.
• El Gateway no se carga: Asegúrate de que la versión de tu host OpenClaw sea 2026.4.10 o superior. Las versiones anteriores no admiten el registro de instalación de plugins externos de npm.