O que wacli faz?
Use o wacli apenas quando o usuário pedir explicitamente para enviar uma mensagem para outra pessoa no WhatsApp ou quando solicitar sincronização/pesquisa do histórico do WhatsApp.
NÃO use o wacli para conversas normais de usuário; o OpenClaw roteia automaticamente as conversas do WhatsApp.
Se o usuário estiver conversando com você no WhatsApp, você não deve usar esta ferramenta, a menos que ele peça para entrar em contato com um terceiro.
Segurança
- Exija destinatário explícito + texto da mensagem.
- Confirme o destinatário + mensagem antes de enviar.
- Se algo estiver ambíguo, faça uma pergunta esclarecedora.
Autenticação + sincronização
wacli auth(login QR + sincronização inicial)wacli sync --follow(sincronização contínua)wacli doctor
Encontrar chats + mensagens
wacli chats list --limit 20 --query "nome ou número"wacli messages search "consulta" --limit 20 --chat <jid>wacli messages search "fatura" --after 2025-01-01 --before 2025-12-31
Backfill de histórico
wacli history backfill --chat <jid> --requests 2 --count 50
Envio
- Texto:
wacli send text --to "+14155551212" --message "Olá! Você está livre às 15h?" - Grupo:
wacli send text --to "[email protected]" --message "Estou atrasado 5 min." - Arquivo:
wacli send file --to "+14155551212" --file /caminho/agenda.pdf --caption "Agenda"
Observações
- Diretório de armazenamento:
~/.wacli(substitua com--store). - Use
--jsonpara saída legível por máquina ao fazer parsing. - O backfill requer que seu telefone esteja online; os resultados são de melhor esforço.
- A CLI do WhatsApp não é necessária para chats rotineiros de usuário; destina-se a mensagens para outras pessoas.
- JIDs: chats diretos têm a aparência
<número>@s.whatsapp.net; grupos têm a aparência<id>@g.us(usewacli chats listpara encontrar).