Plugin pessoal do Zalo

Suporte ao Zalo Personal para OpenClaw por meio de um Plugin, usando zca-js nativo para automatizar uma conta normal de usuário do Zalo.

# Nomeação

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 é 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

Use o pacote sem versão para acompanhar a tag de lançamento oficial atual. Fixe uma versão exata somente quando precisar de uma instalação reproduzível.

Reinicie o Gateway depois.

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

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

Reinicie o Gateway depois.

# 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.

# Relacionado

• Criar plugins
• Plugins da comunidade