Zalo Personal (plugin)

Soporte de Zalo Personal para OpenClaw mediante un plugin, usando zca-js nativo para automatizar una cuenta de usuario normal de Zalo.

Advertencia: La automatización no oficial puede llevar a la suspensión/bloqueo de la cuenta. Usa bajo tu propio riesgo.

Nomenclatura

El id de canal es zalouser para dejar claro que esto automatiza una cuenta personal de usuario de Zalo (no oficial). Reservamos zalo para una posible futura integración con la API oficial de Zalo.

Dónde se ejecuta

Este plugin se ejecuta dentro del proceso del Gateway.

Si usas un Gateway remoto, instala/configúralo en la máquina que ejecuta el Gateway, luego reinicia el Gateway.

No se requiere ningún binario CLI externo de zca/openzca.

Instalación

Opción A: instalar desde npm

openclaw plugins install @openclaw/zalouser

Reinicia el Gateway después.

Opción B: instalar desde una carpeta local (desarrollo)

openclaw plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install

Reinicia el Gateway después.

Configuración

La configuración del canal se encuentra bajo channels.zalouser (no plugins.entries.*):

{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}

CLI

openclaw channels login --channel zalouser
openclaw channels logout --channel zalouser
openclaw channels status --probe
openclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"
openclaw directory peers list --channel zalouser --query "name"

Herramienta de agente

Nombre de herramienta: zalouser

Acciones: send, image, link, friends, groups, me, status

Las acciones de mensajes de canal también soportan react para reacciones a mensajes.