Zalo ClawBot

O 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 de um Zalo Mini App; o ID do plugin na configuração é openclaw-zaloclawbot.

Compatibilidade

Pré-requisitos

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

Instalação com o onboard (recomendado)

openclaw onboard

Escolha Zalo ClawBot no menu de canais. O assistente instala o plugin pelo catálogo oficial (com integridade verificada), exibe o código QR de login no terminal e conclui a configuração do canal depois que você o escaneia com o aplicativo Zalo.

Instalação manual

Para adicionar o canal a um Gateway que já passou pelo onboard:

1. Instale o plugin

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

Use a versão exata fixada para que o OpenClaw verifique o pacote em relação ao hash de integridade do catálogo durante a instalação.

2. Ative o plugin na configuração

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

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

openclaw channels login --channel openclaw-zaloclawbot

Escaneie o código QR exibido no terminal com o aplicativo 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

Ao contrário do canal Zalo padrão, que exige o registro da sua própria Zalo Official Account (OA) e a configuração de credenciais estáticas de desenvolvedor, o Zalo ClawBot é um assistente pessoal vinculado ao proprietário em uma infraestrutura oficial compartilhada:

1. Integração inicial: o código QR direciona para um Zalo Mini App que vincula diretamente ao seu ID de usuário do Zalo um bot privado, recém-provisionado sob uma OA oficial compartilhada.
2. Privacidade vinculada ao proprietário: o bot se comunica somente com seu proprietário. Mensagens de outros usuários são descartadas no nível da plataforma.
3. Caminho pela API oficial: o plugin usa as APIs da Zalo Bot Platform, não automação de navegador ou de sessão web.

Funcionamento interno

O plugin se comunica com o Zalo por meio de um loop persistente de long polling (getUpdates). Webhooks ficam desativados por padrão em execuções locais do Gateway no desktop ou terminal. As mensagens são processadas no lado do cliente e mapeadas para o runtime do seu agente local.

O plugin gerencia as credenciais do bot no diretório de estado do OpenClaw. Trate esse diretório como confidencial e aplique a ele a mesma política de controle de acesso e backup usada para o restante do estado do OpenClaw.

O runtime deste plugin reside inteiramente no pacote externo @zalo-platforms/openclaw-zaloclawbot; os detalhes de comportamento abaixo, além da instalação e configuração, são os informados pelos mantenedores do plugin e não foram verificados em relação ao código-fonte principal do OpenClaw.

Solução de problemas

• Tempo limite do login por QR: o token de login (zbsk) expira após 5 minutos por segurança. Se o código QR expirar antes de você escaneá-lo, execute novamente o comando de login para gerar um novo.
• Falha ao carregar o Gateway: confirme se a versão do host do OpenClaw é 2026.4.10 ou posterior. Versões anteriores não oferecem suporte ao registro de instalação de plugins externos do npm exigido por este ID.

Conteúdo relacionado

• Visão geral dos canais - todos os canais compatíveis
• Zalo - o canal integrado Zalo Bot Creator / Marketplace
• Pareamento - autenticação por mensagem direta e fluxo de pareamento
• Plugins - instalação e gerenciamento de plugins