Zalo Personal (plugin)¶

Suporte ao Zalo Personal para o OpenClaw por meio de um plugin, usando zca-cli para automatizar uma conta normal de usuário do Zalo.

Aviso: A automação não oficial pode levar à suspensão/banimento da conta. Use por sua conta e risco.

Nomenclatura¶

O ID do canal é zalouser para deixar explícito que isso automatiza uma conta pessoal de usuário do Zalo (não oficial). Mantemos zalo reservado para uma possível integração futura com a API oficial do Zalo.

Onde ele roda¶

Este plugin roda dentro do processo do Gateway.

Se você usa um Gateway remoto, instale/configure-o na máquina que executa o Gateway e, em seguida, reinicie o Gateway.

Instalação¶

Opção A: instalar a partir do npm¶

openclaw plugins install @openclaw/zalouser

Reinicie o Gateway depois.

Opção B: instalar a partir de uma pasta local (dev)¶

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

Reinicie o Gateway depois.

Pré-requisito: zca-cli¶

A máquina do Gateway deve ter zca em PATH:

zca --version

Configuração¶

A configuração do canal fica em channels.zalouser (não em 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"

Ferramenta do agente¶

Nome da ferramenta: zalouser

Ações: send, image, link, friends, groups, me, status