Plugin pessoal do Zalo

Suporte ao Zalo Personal para o OpenClaw por meio de um plugin que usa o zca-js nativo para automatizar uma conta normal de usuário do Zalo. Nenhum binário externo da CLI zca/openzca é necessário.

Nomenclatura

O id do canal é zalouser para deixar explícito que ele automatiza uma conta pessoal de usuário do Zalo (não oficial). O id de canal separado zalo corresponde à integração oficial incluída com o Bot/Webhook do Zalo — consulte Zalo.

Onde é executado

Este plugin é executado dentro do processo do Gateway. Para um Gateway remoto, instale-o/configure-o nesse host e reinicie o Gateway.

Instalação

Pelo npm

openclaw plugins install @openclaw/zalouser

Use somente o pacote para acompanhar a tag da versão oficial atual; fixe uma versão exata apenas quando precisar de uma instalação reproduzível. Depois, reinicie o Gateway.

De uma pasta local (desenvolvimento)

PLUGIN_SRC=./path/to/local/zalouser-pluginopenclaw plugins install "$PLUGIN_SRC"cd "$PLUGIN_SRC" && pnpm install

Depois, reinicie o Gateway.

Configuração

A configuração do canal fica em channels.zalouser (não em plugins.entries.*):

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

Consulte Configuração do canal pessoal do Zalo para obter informações sobre controle de acesso a mensagens diretas/grupos, configuração de várias contas, variáveis de ambiente e solução de problemas.

CLI

openclaw channels login --channel zalouseropenclaw channels login --channel zalouser --account <name>openclaw channels logout --channel zalouseropenclaw channels status --probeopenclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"openclaw directory self --channel zalouseropenclaw directory peers list --channel zalouser --query "name"openclaw directory groups list --channel zalouser --query "name"openclaw directory groups members --channel zalouser --group-id <id>

Ferramenta do agente

Nome da ferramenta: zalouser

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

As ações de mensagens do canal (não a ferramenta do agente) também são compatíveis com react para reações a mensagens.

Relacionados

• Configuração do canal pessoal do Zalo
• Zalo (canal oficial de Bot/Webhook)
• Criação de plugins
• ClawHub