Canal Zalo do OpenClaw
Conecte o OpenClaw ao Zalo usando a Zalo Bot Platform. Esta integração permite que seu assistente de IA envie e receba mensagens no aplicativo de mensagens mais popular do Vietnã. Configure um Bot Token, defina sua política de DM e comece a conversar — com suporte para long-polling e webhook.
Zalo Recursos suportados
Mensagens de texto
Suportado
Mídia e arquivos
Não suportado
Reações
Não suportado
Threads
Não suportado
Mensagens de voz
Não suportado
Chat em grupo
Não suportado
Zalo Pré-requisitos
- Uma conta Zalo com acesso à Zalo Bot Platform (bot.zaloplatforms.com)
- Um Bot Token obtido no painel da Zalo Bot Platform
- OpenClaw Gateway em execução e configurado
- Para o modo webhook: um endpoint HTTPS acessível publicamente
Zalo Configuração rápida
Criar um Bot Zalo e obter seu Token
Acesse bot.zaloplatforms.com, faça login com sua conta Zalo e crie um novo bot. Copie o Bot Token (formato: 12345689:abc-xyz) do painel.
Adicionar a configuração do canal Zalo
Adicione a configuração do canal Zalo em ~/.openclaw/openclaw.json. Defina botToken, dmPolicy (pairing, allowlist, open ou disabled) e, opcionalmente, configure as definições de webhook.
Iniciar o Gateway e testar
Inicie o Gateway com 'openclaw start'. O bot se conectará por padrão no modo long-polling. Envie uma mensagem para seu bot no Zalo para verificar se a conexão funciona.
Zalo Exemplo de configuração
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz",
"dmPolicy": "pairing"
}
}
}Zalo Documentação Detalhada
Visão geral da arquitetura
Criando seu Bot Zalo
{
"channels": {
"zalo": {
"enabled": true,
"botToken": "12345689:abc-xyz"
}
}
}Políticas de DM
{
"channels": {
"zalo": {
"dmPolicy": "allowlist",
"allowFrom": ["123456789", "987654321"]
}
}
}Configuração de Webhook
{
"channels": {
"zalo": {
"botToken": "12345689:abc-xyz",
"webhookUrl": "https://your-server.com/zalo/webhook",
"webhookSecret": "your-secret-string-8-to-256-chars",
"webhookPath": "/zalo/webhook"
}
}
}Tratamento de mensagens
Configuração multi-conta
{
"channels": {
"zalo": {
"accounts": {
"support-bot": {
"botToken": "token-for-support-bot",
"dmPolicy": "open"
},
"team-bot": {
"botToken": "token-for-team-bot",
"dmPolicy": "allowlist",
"allowFrom": ["111222333"]
}
}
}
}
}Envio de mensagens
openclaw message send --channel zalo --target 123456789Configuração de proxy
{
"channels": {
"zalo": {
"proxy": "http://proxy.example.com:8080"
}
}
}Zalo Referência de Configuração
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Ativar ou desativar o canal Zalo |
| botToken | string | "" | Bot Token da Zalo Bot Platform (bot.zaloplatforms.com) |
| tokenFile | string | "" | Ler o Bot Token de um caminho de arquivo em vez da configuração inline |
| dmPolicy | string | "pairing" | Controla quem pode enviar DMs ao bot. Opções: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | IDs de usuário numéricos do Zalo autorizados a se comunicar com o bot (quando dmPolicy é allowlist) |
| mediaMaxMb | number | 5 | Tamanho máximo de arquivo de mídia recebida em megabytes |
| webhookUrl | string | "" | URL HTTPS para o modo webhook. Quando definido, o long-polling é desativado |
| webhookSecret | string | "" | String secreta (8-256 caracteres) para verificação de webhook via cabeçalho X-Bot-Api-Secret-Token |
| webhookPath | string | "" | Caminho de webhook personalizado no servidor HTTP do Gateway |
| proxy | string | "" | URL do proxy para requisições de API de saída para o Zalo |
| accounts.<id>.botToken | string | "" | Bot Token para uma conta específica no modo multi-conta |
| accounts.<id>.dmPolicy | string | "pairing" | Substituição da política de DM para uma conta específica |
| accounts.<id>.webhookUrl | string | "" | Substituição da URL de webhook para uma conta específica |
Ativar ou desativar o canal Zalo
Bot Token da Zalo Bot Platform (bot.zaloplatforms.com)
Ler o Bot Token de um caminho de arquivo em vez da configuração inline
Controla quem pode enviar DMs ao bot. Opções: pairing, allowlist, open, disabled
IDs de usuário numéricos do Zalo autorizados a se comunicar com o bot (quando dmPolicy é allowlist)
Tamanho máximo de arquivo de mídia recebida em megabytes
URL HTTPS para o modo webhook. Quando definido, o long-polling é desativado
String secreta (8-256 caracteres) para verificação de webhook via cabeçalho X-Bot-Api-Secret-Token
Caminho de webhook personalizado no servidor HTTP do Gateway
URL do proxy para requisições de API de saída para o Zalo
Bot Token para uma conta específica no modo multi-conta
Substituição da política de DM para uma conta específica
Substituição da URL de webhook para uma conta específica
Zalo Perguntas Frequentes
Zalo Solução de Problemas
O Bot Token pode estar inválido, expirado, ou o Gateway não está em execução. No modo webhook, o endpoint HTTPS pode estar inacessível.
O long-polling tem latência inerente comparado ao modo webhook. Instabilidade de rede também pode causar agrupamento de mensagens.
A dmPolicy pode não estar definida como 'pairing', ou o bot não está conectado corretamente ao Zalo.
O arquivo de imagem pode exceder o limite de mediaMaxMb, ou a API do Zalo pode estar temporariamente indisponível.
O webhookSecret na sua configuração não corresponde ao que o Zalo espera, ou o endpoint não está retornando a resposta correta.