WhatSyncComo configurar o OpenClaw no WhatsApp, e quando você quer um MCP de WhatsApp
Como funciona o canal de WhatsApp do OpenClaw, os comandos para conectar, as configurações que mantêm estranhos de fora, e por que é um trabalho diferente de deixar o Claude ou o ChatGPT trabalhar nas suas próprias conversas do WhatsApp.
· 7 min de leitura
A resposta rápida
Use o canal de WhatsApp do OpenClaw quando você quer mandar mensagem para o seu próprio agente de IA pelo celular, de preferência num número reserva. Use um servidor MCP de WhatsApp quando você quer que o Claude, o ChatGPT ou o próprio OpenClaw leiam, pesquisem e respondam nas suas conversas de verdade.
Lado a lado
| Critério | Canal de WhatsApp do OpenClaw | Servidor MCP de WhatsApp (WhatSync) |
|---|---|---|
| Para que serve | Mandar mensagem para o seu agente pelo WhatsApp | A sua IA lendo e respondendo nas suas próprias conversas |
| Qual número | Recomenda-se um número reserva | O seu próprio número |
| Quem fala com a IA | Os números da sua lista de permitidos | Só você, dentro do seu app de IA |
| Onde roda | No seu gateway do OpenClaw, que precisa ficar ligado | Hospedado |
| Pesquisa as suas conversas | Não, ele cuida das mensagens novas para o agente | Sim, todas as mensagens salvas nas conversas que você escolher |
| Funciona em | OpenClaw | Claude, ChatGPT, Cursor, Codex, e o OpenClaw como ferramenta MCP |
| Preço | Grátis e de código aberto, mais o custo do seu modelo de IA | US$ 19 por mês, US$ 15 no plano anual |
Fatos do OpenClaw tirados da documentação dele, conferidos em 3 de outubro de 2026. Os comandos podem mudar entre versões; rode o comando de ajuda se algum falhar.
Como o OpenClaw se conecta ao WhatsApp
O OpenClaw conecta o WhatsApp do mesmo jeito que o WhatsApp Web. Ele usa a biblioteca Baileys para agir como dispositivo conectado, e o gateway dele mantém essa conexão aberta. Não tem conta de desenvolvedor da Meta nem API do Business no meio.
Depois de conectado, as mensagens que as pessoas permitidas mandam para aquele número chegam ao seu agente, e as respostas do agente voltam como mensagens do WhatsApp. A sessão fica salva em ~/.openclaw/credentials/whatsapp/, então você só escaneia o QR code de novo se desconectar o dispositivo pelo celular ou se a sessão expirar.
Configurando
A documentação do OpenClaw dá três passos. Adicione o canal com "openclaw channels add --channel whatsapp". Conecte com "openclaw channels login --channel whatsapp", que mostra um QR code no terminal; no celular com o número que você quer usar, abra o WhatsApp, vá em Dispositivos conectados, toque em Conectar dispositivo e escaneie. Depois inicie o gateway com "openclaw gateway".
Antes de iniciar o gateway, defina quem pode falar com o agente. O bloco do WhatsApp na sua configuração aceita um dmPolicy e uma lista allowFrom de números no formato internacional, como +5511999990000. A política padrão, pairing, pede para você aprovar remetentes desconhecidos. A allowlist só deixa entrar os números da lista. Os grupos têm a própria política e lista de permitidos, e por padrão o agente só responde num grupo quando é mencionado.
Use um número reserva
A documentação do OpenClaw recomenda um número dedicado. Se você conectar o seu WhatsApp principal, o agente age como você, e as mensagens para você mesmo ficam confusas. Um segundo chip barato ou um número do app WhatsApp Business em outro celular funciona bem.
Problemas comuns
- O agente para de responder: o gateway não está rodando. As respostas só funcionam enquanto ele está conectado, então rode numa máquina que fica ligada.
- As mensagens de um amigo são ignoradas: o número dele não está no allowFrom, ou não está no formato +código do país.
- O agente ignora um grupo: os grupos precisam da própria lista de permitidos, e o agente espera ser mencionado, a não ser que você desligue isso.
- Você precisa escanear de novo: o dispositivo foi removido em Dispositivos conectados no celular, ou o WhatsApp desconectou porque o celular ficou offline tempo demais. O WhatsApp aceita até quatro dispositivos conectados por número.
Mandar mensagem para o seu agente não é o mesmo que o agente usar o seu WhatsApp
Muita gente configura o canal de WhatsApp do OpenClaw esperando que o agente ajude com as próprias conversas: se atualizar sobre os grupos, achar o que um cliente disse, responder pessoas. O canal não foi feito para isso. Ele transforma o WhatsApp numa janela de conversa com o agente; não dá ao agente a sua caixa de entrada.
Para esse trabalho você quer um servidor MCP de WhatsApp conectado ao seu próprio número. Ele dá a um app de IA ferramentas para listar as suas conversas, pesquisar todas as mensagens, achar as conversas esperando a sua resposta e enviar respostas que você aprova. O WhatSync é um servidor hospedado que funciona no Claude e no ChatGPT sem instalar nada. O OpenClaw também usa servidores MCP remotos, então você pode dar as mesmas ferramentas ao seu agente do OpenClaw; veja os comandos na documentação de MCP dele.
- Compare as opções: os melhores servidores MCP de WhatsApp.
- Configure o WhatSync no Claude: guia do Claude com WhatsApp (em inglês).
Perguntas
- O OpenClaw usa a API do WhatsApp Business?
- Não. O canal de WhatsApp dele conecta um número como dispositivo, igual ao WhatsApp Web, usando a biblioteca Baileys. Não precisa de conta de desenvolvedor da Meta.
- Dá para usar o meu número pessoal do WhatsApp com o OpenClaw?
- O OpenClaw aceita, mas a documentação recomenda um número separado. Com o seu número principal conectado, o agente age como você e pode enviar pela sua conta de verdade.
- O OpenClaw consegue ler as minhas conversas do WhatsApp que já existem?
- O canal é feito para as mensagens novas enviadas ao agente, não para pesquisar o seu histórico. Para uma IA trabalhar nas suas conversas, use um servidor MCP de WhatsApp como o WhatSync (em inglês).
- Por que o meu WhatsApp no OpenClaw parou de funcionar?
- Normalmente o gateway parou, ou o dispositivo conectado foi desconectado. Inicie o gateway de novo e, se ele pedir, rode o comando de login e escaneie um novo QR code.
- Posso ser banido por usar o OpenClaw no WhatsApp?
- Conversas normais, de você com o seu próprio agente, parecem uso normal do WhatsApp. Mandar mensagens em massa ou não solicitadas pelo número conectado quebra as regras do WhatsApp e pode fazer ele ser restringido.
Fontes
Conferimos as páginas oficiais dos fornecedores e os READMEs dos projetos, não outros artigos de comparação, e dizemos quando usamos a imprensa. O WhatSync publica este artigo e é uma das opções comparadas.
- Documentação do canal WhatsApp do OpenClaw: Comando de login, conselho sobre número dedicado, dmPolicy e allowFrom, onde a sessão fica salva (em inglês).
- Documentação de MCP do OpenClaw: Como adicionar servidores MCP remotos e entrar neles (em inglês).
- Central de Ajuda do WhatsApp: dispositivos conectados: Até quatro dispositivos conectados, e como desconectar um pelo celular.
- Servidor MCP do WhatsApp do WhatSync: Configuração para cada app de IA e a lista completa de ferramentas (em inglês).
Continue lendo
Use o seu WhatsApp no Claude, no ChatGPT ou em qualquer agente de IA
Adicione o WhatSync ao seu app de IA, conecte o seu WhatsApp e pergunte sobre as suas conversas. Funciona com o WhatsApp pessoal e com a API do WhatsApp Business.