ClawBot de Zalo

OpenClaw se conecta a Zalo ClawBot mediante el plugin externo @zalo-platforms/openclaw-zaloclawbot incluido en el catálogo. El inicio de sesión utiliza un código QR de Zalo Mini App; el id. del plugin en la configuración es openclaw-zaloclawbot.

Compatibilidad

Requisitos previos

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

Instalación con el asistente de incorporación (recomendada)

openclaw onboard

Selecciona Zalo ClawBot en el menú de canales. El asistente instala el plugin desde el catálogo oficial (con verificación de integridad), muestra el código QR de inicio de sesión en la terminal y completa la configuración del canal cuando lo escaneas con la aplicación de Zalo.

Instalación manual

Para añadir el canal a un Gateway que ya haya completado la incorporación:

1. Instala el plugin

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

Usa la versión fijada exacta para que OpenClaw verifique el paquete con 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 un código QR e inicia sesión

openclaw channels login --channel openclaw-zaloclawbot

Escanea el código QR mostrado en la terminal con la aplicación móvil de Zalo, acepta las condiciones de uso dentro de Zalo Mini App y autoriza la sesión.

4. Reinicia el Gateway

openclaw gateway restart

Funcionamiento

A diferencia del canal estándar de Zalo, que requiere registrar tu propia cuenta oficial de Zalo (OA) y configurar credenciales estáticas de desarrollador, Zalo ClawBot es un asistente personal vinculado a su propietario que se ejecuta en una infraestructura oficial compartida:

1. Incorporación: el código QR dirige a una Zalo Mini App que vincula un bot privado recién aprovisionado, alojado bajo una OA oficial compartida, directamente con tu identificador de usuario de Zalo.
2. Privacidad vinculada al propietario: el bot solo se comunica con su propietario. Los mensajes de otros usuarios se descartan en la plataforma.
3. Ruta de API oficial: el plugin utiliza las API de Zalo Bot Platform, no automatización del navegador ni de sesiones web.

Funcionamiento interno

El plugin se comunica con Zalo mediante un bucle persistente de sondeo largo (getUpdates). Los Webhooks están deshabilitados de forma predeterminada en las ejecuciones locales del Gateway desde el escritorio o la terminal. Los mensajes se procesan en el cliente y se asignan al entorno de ejecución de tu agente local.

El plugin administra las credenciales del bot en el directorio de estado de OpenClaw. Considera confidencial ese directorio y protégelo con la misma política de control de acceso y copias de seguridad que el resto del estado de OpenClaw.

El entorno de ejecución de este plugin reside íntegramente en el paquete externo @zalo-platforms/openclaw-zaloclawbot; los detalles de comportamiento que aparecen a continuación, aparte de la instalación y la configuración, proceden de la información facilitada por los responsables del plugin y no se han verificado con el código fuente del núcleo de OpenClaw.

Solución de problemas

• Tiempo de espera agotado al iniciar sesión mediante 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, vuelve a ejecutar el comando de inicio de sesión para generar uno nuevo.
• El Gateway no se carga: confirma que la versión de OpenClaw del host sea 2026.4.10 o posterior. Las versiones anteriores no admiten el registro de instalación de plugins externos de npm que requiere este identificador.

Temas relacionados

• Descripción general de los canales - todos los canales compatibles
• Zalo - el canal integrado de Zalo Bot Creator / Marketplace
• Emparejamiento - autenticación mediante mensajes directos y flujo de emparejamiento
• Plugins - instalación y administración de plugins