wacli

• Você quer que seu agente envie uma mensagem de WhatsApp para um contato ou grupo específico em seu nome (por exemplo, notificar um cliente, alertar um grupo da equipe).
• Você precisa pesquisar conversas anteriores do WhatsApp por palavras-chave, datas ou contatos específicos de forma programática.
• Você quer sincronizar e preencher o histórico do WhatsApp em um armazenamento local para processamento ou consulta posterior.
• Você precisa enviar arquivos ou documentos (PDFs, imagens, etc.) para um destinatário do WhatsApp com uma legenda opcional.

• Você mesmo está conversando com o agente via WhatsApp — o OpenClaw lida com essas conversas automaticamente; não invoque o wacli para sua própria sessão de chat.
• Você precisa receber ou responder a mensagens do WhatsApp em tempo real; o wacli é uma ferramenta de envio/consulta, não um listener de caixa de entrada.
• O destinatário ou o conteúdo da mensagem está ambíguo — sempre confirme os detalhes antes de enviar.

Use wacli send text para entregar uma mensagem a qualquer número de telefone ou JID de grupo do WhatsApp. Suporta tanto conversas diretas (<número>@s.whatsapp.net) quanto conversas em grupo (<id>@g.us).

Anexe e entregue arquivos (PDFs, imagens e mais) para qualquer contato ou grupo do WhatsApp usando wacli send file, com uma string de legenda opcional.

Consulte seu histórico do WhatsApp sincronizado por palavra-chave, intervalo de datas e conversa usando wacli messages search. Útil para recuperar o contexto de conversas anteriores antes de tomar uma ação.

wacli chats list permite buscar contatos ou grupos por nome ou número, e retorna seus JIDs necessários para enviar mensagens ou pesquisar dentro de uma conversa específica.

Use wacli history backfill para recuperar mensagens mais antigas dos servidores do WhatsApp para o armazenamento local. Requer que seu telefone esteja online; os resultados são obtidos com base no melhor esforço possível.

wacli auth gerencia o login por QR code e a sincronização inicial. wacli sync --follow mantém seu armazenamento local continuamente atualizado. wacli doctor ajuda a diagnosticar problemas de conexão.

Um agente detecta um atraso em reunião ou mudança de status e usa wacli send text para notificar o contato relevante ou grupo no WhatsApp sem nenhuma etapa manual.

Um agente gera um relatório ou agenda em PDF e o entrega diretamente a um destinatário no WhatsApp usando wacli send file com uma legenda descritiva.

Antes de redigir um acompanhamento, um agente pesquisa o histórico do WhatsApp por um tópico ou palavra-chave específica (por exemplo, wacli messages search "invoice" --after 2025-01-01) para localizar mensagens anteriores relevantes.

Um fluxo de trabalho sincroniza e preenche retroativamente o histórico de mensagens do WhatsApp em um armazenamento local (~/.wacli), para que ferramentas subsequentes possam consultar, indexar ou analisar dados de conversas.