Skip to main content

​
Zalo Personal (plugin)

Suporte ao Zalo Personal para o OpenClaw por meio de um plugin, usando zca-js nativo para automatizar uma conta comum de usuário do Zalo.
Aviso: 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 futura integração oficial com a API do Zalo.

​
Onde ele é executado

Este plugin é executado dentro do processo do Gateway. Se você usa um Gateway remoto, instale/configure-o na máquina que executa o Gateway e depois reinicie o Gateway. Nenhum binário externo de CLI zca/openzca é necessário.

​
Instalação

​
Opção A: instalar pelo npm

openclaw plugins install @openclaw/zalouser
Reinicie o Gateway em seguida.

​
Opção B: instalar de uma pasta local (desenvolvimento)

PLUGIN_SRC=./path/to/local/zalouser-plugin
openclaw plugins install "$PLUGIN_SRC"
cd "$PLUGIN_SRC" && pnpm install
Reinicie o Gateway em seguida.

​
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 As ações de mensagem do canal também oferecem suporte a react para reações a mensagens.