Zalo ClawBot

OpenClaw se conecta ao Zalo ClawBot por meio do Plugin externo @zalo-platforms/openclaw-zaloclawbot listado no catálogo. O login usa um código QR do Zalo Mini App.

Compatibilidade

Pré-requisitos

• Node.js >= 22
• OpenClaw deve estar instalado (CLI openclaw disponível).
• Uma conta Zalo em um dispositivo móvel para escanear o código QR de login.

Instalar com onboard (recomendado)

Execute o assistente de integração do OpenClaw e escolha Zalo ClawBot no menu de canais:

openclaw onboard

O assistente instala o Plugin a partir do catálogo oficial (com integridade verificada), renderiza o QR de login diretamente no terminal e conclui o canal assim que você o escaneia com o app Zalo. Nenhum comando extra é necessário.

Instalação manual

Para adicionar o canal a um Gateway já integrado, siga estas etapas:

1. Instale o Plugin

openclaw plugins install "@zalo-platforms/openclaw-zaloclawbot@0.1.4"

Use a versão fixada exata mostrada acima (ela corresponde à entrada do catálogo oficial), para que o OpenClaw verifique o pacote em relação ao hash de integridade do catálogo durante a instalação.

2. Habilite o Plugin na configuração

openclaw config set plugins.entries.openclaw-zaloclawbot.enabled true

3. Gere o código QR e faça login

openclaw channels login --channel openclaw-zaloclawbot

Escaneie o código QR renderizado no terminal usando o app móvel Zalo, aceite os Termos de Uso dentro do Zalo Mini App e autorize a sessão.

4. Reinicie o Gateway

openclaw gateway restart

Como funciona

Diferentemente do canal Zalo padrão para desenvolvedores, que exige que você registre sua própria Conta Oficial Zalo (OA) e cole credenciais estáticas de desenvolvedor, o Zalo ClawBot opera como um assistente pessoal vinculado ao proprietário usando uma infraestrutura oficial compartilhada:

1. Integração segura: O código QR resolve para um Zalo Mini App seguro que vincula um bot privado recém-provisionado, sob uma OA oficial compartilhada, diretamente ao seu ID de usuário Zalo.
2. Privacidade vinculada ao proprietário: Por design, o bot é restrito a se comunicar somente com seu proprietário. Mensagens de outros usuários são descartadas no nível da plataforma, tornando a conexão privada e segura.
3. Caminho de API oficial: O Plugin usa APIs da Zalo Bot Platform em vez de automação de navegador ou sessão web.

Por dentro

O Plugin Zalo ClawBot se comunica com as APIs da Zalo por meio de um loop persistente de mensagens com long polling. Para manter um runtime limpo e leve:

• Conexões de long polling utilizam o endpoint getUpdates.
• Webhooks são desabilitados por padrão para execuções locais do Gateway em desktop/terminal.
• As mensagens são processadas no lado do cliente e mapeadas diretamente para o runtime do seu agente local.

O Plugin externo gerencia credenciais de bot no diretório de estado do OpenClaw. Trate esse diretório como sensível e inclua-o na mesma política de controle de acesso e backup do restante do seu estado do OpenClaw.

Solução de problemas

• Tempo limite do login por QR: O token de login (zbsk) expira após 5 minutos por motivos de segurança. Se o código QR expirar antes de você escaneá-lo, basta executar novamente o comando de login para gerar um novo.
• Gateway não carrega: Verifique se a versão do host OpenClaw é 2026.4.10 ou superior. Versões mais antigas não oferecem suporte ao registro de instalação de Plugins npm externos.