wacli

• Vuoi che il tuo agente invii un messaggio WhatsApp a un contatto o gruppo specifico per tuo conto (ad esempio, per notificare un cliente o avvisare un gruppo del team).
• Hai bisogno di cercare conversazioni WhatsApp passate per parole chiave, date o contatti specifici in modo programmatico.
• Vuoi sincronizzare e recuperare la cronologia di WhatsApp in un archivio locale per elaborazioni o ricerche successive.
• Hai bisogno di inviare file o documenti (PDF, immagini, ecc.) a un destinatario WhatsApp con una didascalia opzionale.

• Stai chattando con l'agente tramite WhatsApp tu stesso — OpenClaw gestisce quelle conversazioni automaticamente; non invocare wacli per la tua sessione di chat personale.
• Hai bisogno di ricevere o rispondere a messaggi WhatsApp in arrivo in tempo reale; wacli è uno strumento per l'invio/interrogazione, non un listener della casella di posta in arrivo.
• Il destinatario o il contenuto del messaggio è ambiguo — conferma sempre i dettagli prima di inviare.

Usa wacli send text per inviare un messaggio a qualsiasi numero di telefono o JID di gruppo WhatsApp. Supporta sia le chat dirette (<numero>@s.whatsapp.net) che le chat di gruppo (<id>@g.us).

Allega e consegna file (PDF, immagini e altro) a qualsiasi contatto o gruppo WhatsApp utilizzando wacli send file, con una stringa di didascalia opzionale.

Interroga la tua cronologia WhatsApp sincronizzata per parola chiave, intervallo di date e chat usando wacli messages search. Utile per recuperare il contesto di conversazioni passate prima di intraprendere un'azione.

wacli chats list ti permette di cercare contatti o gruppi per nome o numero, e restituisce i loro JID necessari per inviare messaggi o effettuare ricerche all'interno di una chat specifica.

Usa wacli history backfill per recuperare i messaggi più vecchi dai server di WhatsApp nell'archivio locale. Richiede che il tuo telefono sia online; i risultati sono forniti nella misura del possibile.

wacli auth gestisce il login tramite QR code e la sincronizzazione iniziale. wacli sync --follow mantiene il tuo archivio locale continuamente aggiornato. wacli doctor aiuta a diagnosticare i problemi di connessione.

Un agente rileva un ritardo in una riunione o un cambiamento di stato e utilizza wacli send text per notificare il contatto pertinente o la chat di gruppo WhatsApp senza alcun passaggio manuale.

Un agente genera un report PDF o un'agenda e la consegna direttamente a un destinatario WhatsApp utilizzando wacli send file con una didascalia descrittiva.

Prima di redigere un messaggio di follow-up, un agente cerca nella cronologia di WhatsApp un argomento o una parola chiave specifica (ad es., wacli messages search "invoice" --after 2025-01-01) per recuperare i messaggi precedenti pertinenti.

Un flusso di lavoro sincronizza e ripristina la cronologia dei messaggi WhatsApp in un archivio locale (~/.wacli), in modo che gli strumenti a valle possano interrogare, indicizzare o analizzare i dati delle conversazioni.