Canal Zalo de OpenClaw
Conecta OpenClaw a Zalo mediante la Zalo Bot Platform. Esta integración permite que tu asistente de IA envíe y reciba mensajes en la aplicación de mensajería más popular de Vietnam. Configura un Bot Token, establece tu política de DM y comienza a chatear — con soporte para long-polling y webhook.
Zalo Funciones compatibles
Mensajes de texto
Compatible
Medios y archivos
No compatible
Reacciones
No compatible
Hilos
No compatible
Mensajes de voz
No compatible
Chat grupal
No compatible
Zalo Requisitos previos
- Una cuenta de Zalo con acceso a la Zalo Bot Platform (bot.zaloplatforms.com)
- Un Bot Token obtenido desde el panel de la Zalo Bot Platform
- OpenClaw Gateway en ejecución y configurado
- Para el modo webhook: un endpoint HTTPS accesible públicamente
Zalo Configuración rápida
Crear un Bot de Zalo y obtener tu Token
Ve a bot.zaloplatforms.com, inicia sesión con tu cuenta de Zalo y crea un nuevo bot. Copia el Bot Token (formato: 12345689:abc-xyz) desde el panel.
Agregar la configuración del canal Zalo
Agrega la configuración del canal Zalo a ~/.openclaw/openclaw.json. Establece botToken, dmPolicy (pairing, allowlist, open o disabled) y opcionalmente configura los ajustes de webhook.
Iniciar el Gateway y probar
Inicia el Gateway con 'openclaw start'. El bot se conectará por defecto en modo long-polling. Envía un mensaje a tu bot en Zalo para verificar que la conexión funciona.
Zalo Ejemplo de configuración
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz",
"dmPolicy": "pairing"
}
}
}Zalo Documentación Detallada
Descripción de la arquitectura
Creación de tu Bot de Zalo
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz"
}
}
}Políticas de DM
{
"channels": {
"zalo": {
"dmPolicy": "allowlist",
"allowFrom": ["123456789", "987654321"]
}
}
}Configuración de Webhook
{
"channels": {
"zalo": {
"botToken": "12345689:abc-xyz",
"webhookUrl": "https://your-server.com/zalo/webhook",
"webhookSecret": "your-secret-string-8-to-256-chars",
"webhookPath": "/zalo/webhook"
}
}
}Manejo de mensajes
Configuración multi-cuenta
{
"channels": {
"zalo": {
"accounts": {
"support-bot": {
"botToken": "token-for-support-bot",
"dmPolicy": "open"
},
"team-bot": {
"botToken": "token-for-team-bot",
"dmPolicy": "allowlist",
"allowFrom": ["111222333"]
}
}
}
}
}Mensajería saliente
openclaw message send --channel zalo --target 123456789Configuración de proxy
{
"channels": {
"zalo": {
"proxy": "http://proxy.example.com:8080"
}
}
}Zalo Referencia de Configuración
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Activar o desactivar el canal Zalo |
| botToken | string | "" | Bot Token de la Zalo Bot Platform (bot.zaloplatforms.com) |
| tokenFile | string | "" | Leer el Bot Token desde una ruta de archivo en lugar de la configuración en línea |
| dmPolicy | string | "pairing" | Controla quién puede enviar DMs al bot. Opciones: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | IDs de usuario numéricos de Zalo autorizados para comunicarse con el bot (cuando dmPolicy es allowlist) |
| mediaMaxMb | number | 5 | Tamaño máximo de archivo de medios entrantes en megabytes |
| webhookUrl | string | "" | URL HTTPS para el modo webhook. Al establecerla, se desactiva el long-polling |
| webhookSecret | string | "" | Cadena secreta (8-256 caracteres) para verificación de webhook vía encabezado X-Bot-Api-Secret-Token |
| webhookPath | string | "" | Ruta de webhook personalizada en el servidor HTTP del Gateway |
| proxy | string | "" | URL del proxy para solicitudes de API salientes hacia Zalo |
| accounts.<id>.botToken | string | "" | Bot Token para una cuenta específica en modo multi-cuenta |
| accounts.<id>.dmPolicy | string | "pairing" | Anulación de política de DM para una cuenta específica |
| accounts.<id>.webhookUrl | string | "" | Anulación de URL de webhook para una cuenta específica |
Activar o desactivar el canal Zalo
Bot Token de la Zalo Bot Platform (bot.zaloplatforms.com)
Leer el Bot Token desde una ruta de archivo en lugar de la configuración en línea
Controla quién puede enviar DMs al bot. Opciones: pairing, allowlist, open, disabled
IDs de usuario numéricos de Zalo autorizados para comunicarse con el bot (cuando dmPolicy es allowlist)
Tamaño máximo de archivo de medios entrantes en megabytes
URL HTTPS para el modo webhook. Al establecerla, se desactiva el long-polling
Cadena secreta (8-256 caracteres) para verificación de webhook vía encabezado X-Bot-Api-Secret-Token
Ruta de webhook personalizada en el servidor HTTP del Gateway
URL del proxy para solicitudes de API salientes hacia Zalo
Bot Token para una cuenta específica en modo multi-cuenta
Anulación de política de DM para una cuenta específica
Anulación de URL de webhook para una cuenta específica
Zalo Preguntas Frecuentes
Zalo Solución de Problemas
El Bot Token puede ser inválido, estar expirado, o el Gateway no está ejecutándose. En modo webhook, el endpoint HTTPS puede ser inaccesible.
El long-polling tiene una latencia inherente en comparación con el modo webhook. La inestabilidad de red también puede causar agrupación de mensajes.
La dmPolicy puede no estar establecida en 'pairing', o el bot no está correctamente conectado a Zalo.
El archivo de imagen puede exceder el límite de mediaMaxMb, o la API de Zalo puede estar temporalmente no disponible.
El webhookSecret en tu configuración no coincide con lo que Zalo espera, o el endpoint no está devolviendo la respuesta correcta.