WhatsApp, c'est pratique, mais c'est aussi une prison dorée : vos années de messages vivent dans l'application de Meta, et le jour où vous cherchez ce vieux fil de discussion perdu, vous en êtes réduit à scroller comme un forcené. Peter Steinberger, le papa de PSPDFKit, s'est mis en tête de faire sauter les barreaux. Sa réponse s'appelle wacli : un client WhatsApp qui tourne exclusivement dans votre terminal, rapatrie tout en local et vous rend la main sur vos propres données. Je l'ai repris en main pour cette mise à jour, parce que le projet a beaucoup bougé depuis mon premier essai, et parce qu'une des versions publiées entre-temps corrige un bug qui empêche purement et simplement de se connecter. Voilà où en est l'outil, ce qu'il sait faire aujourd'hui, et ce qu'il vaut mieux savoir avant de l'installer.

Ce qui a changé depuis la version 0.10

Commençons par le plus urgent. Si vous aviez noté quelque part d'installer wacli en 0.10.0, oubliez : cette version ne se connecte plus. WhatsApp a fait évoluer son protocole, et les clients qui n'ont pas suivi se prennent une erreur 405 (Client Outdated) au moment de l'appairage. Le correctif est arrivé avec la 0.11.2, début juillet 2026, et la 0.13.0 a remis une couche en actualisant à nouveau la bibliothèque sous-jacente pour coller aux échanges réseau actuels, aux envois vers les identifiants LID et à la procédure d'appairage.

N'installez pas une version antérieure à la 0.11.2, et de préférence prenez directement la dernière. Une 0.10.0 récupérée sur une archive ou dans un vieux tutoriel échouera à l'appairage avec une erreur 405 (Client Outdated), sans message explicite sur la cause.

Au 19 août 2026, la version courante est la 0.13.0, publiée le 17 juillet. Entre les deux, quatre versions se sont succédé, et elles n'ont pas fait que corriger des bugs : les commandes d'administration de groupe, le retrait et le transfert de messages, la récupération différée des médias et un mode de synchronisation discret sont tous apparus dans cet intervalle. J'y reviens en détail plus bas.

Deux autres changements méritent d'être signalés parce qu'ils cassent les anciennes instructions. Le dépôt a migré sous l'organisation openclaw, et avec lui le tap Homebrew : la commande d'installation n'est plus la même qu'avant. Enfin, sous Windows, la 0.13.0 corrige la gestion des chemins avec lettre de lecteur et des chemins réseau UNC, qui faisaient échouer l'ouverture de la base locale. Si vous aviez essayé wacli sous Windows et abandonné, c'est peut-être le moment de réessayer.

Qui se cache derrière wacli

Peter Steinberger n'est pas un inconnu dans le petit monde du développement : c'est le fondateur de PSPDFKit, devenu Nutrient, la brique logicielle qui gère les PDF dans une flopée d'applications. Sorti de sa retraite pour bricoler dans l'IA, il a lancé wacli, aujourd'hui hébergé sous l'organisation openclaw. Le projet a depuis changé de main au quotidien : Steinberger en reste le créateur, mais la maintenance courante est assurée par un contributeur nommé dans le dépôt, dinakars777, épaulé par une bonne dizaine de contributeurs réguliers dont les noms apparaissent à chaque note de version.

Le projet cumule environ 2 700 étoiles et plus de 330 forks sur GitHub. Ce n'est pas un chiffre spectaculaire à l'échelle de la plateforme, mais pour un utilitaire en ligne de commande sur un sujet aussi niche, ça en dit long sur l'appétit des gens pour reprendre le contrôle de leur messagerie. L'ensemble est publié sous licence MIT, et la documentation complète vit sur wacli.sh.

Le principe : un client WhatsApp qui vit dans le terminal

L'idée est limpide. wacli se connecte à votre compte comme un appareil lié, exactement comme WhatsApp Web, puis rapatrie vos conversations sur votre machine. À partir de là, tout se passe chez vous : la lecture, la recherche, l'export, et même l'envoi.

Petite précision que je n'avais pas apportée la première fois, et qui compte quand on parle de sécurité : wacli n'utilise pas une seule base de données mais deux, volontairement séparées. Un fichier session.db contient les clés de session WhatsApp, et un fichier wacli.db contient les messages et leur index de recherche. S'y ajoutent un dossier media/ pour les pièces jointes téléchargées et un fichier LOCK qui empêche deux instances de wacli de se marcher dessus. Le tout est créé en permissions restreintes, accessibles au seul propriétaire du compte. Ne les élargissez pas : ce sont vos clés de session qui sont dedans.

Comme c'est un outil en ligne de commande, chaque action est une commande que vous pouvez enchaîner, scripter et automatiser dans la joie et la bonne humeur, comme avec n'importe quel utilitaire Unix. C'est là toute la philosophie : vos messages ne sont plus prisonniers d'une interface, ils deviennent de la donnée que vous manipulez à votre guise.

Appairer wacli : QR code ou numéro de téléphone

La méthode classique passe par le QR code. Vous lancez wacli auth, le terminal affiche un QR, vous le scannez depuis l'écran « Appareils connectés » de WhatsApp sur votre téléphone, et la première synchronisation démarre dans la foulée. Ensuite, wacli sync --follow maintient la base locale à jour en continu, sans redemander de QR code.

Il existe une alternative que je trouve pratique et qui reste peu connue : l'appairage par numéro de téléphone, documenté dans le guide de démarrage rapide. Vous saisissez votre numéro, WhatsApp affiche un code à huit caractères sur le téléphone, et vous le validez. C'est nettement plus confortable quand vous travaillez sur un serveur distant en SSH, où l'affichage d'un QR code en ASCII dans un terminal étroit relève parfois du sport de combat.

Seule la commande auth affiche un QR code. La commande sync ne le fait jamais et échoue avec un message clair si la session n'est pas déjà appairée. C'est voulu : elle doit rester utilisable dans un script ou un service qui tourne sans personne devant l'écran.

La recherche hors ligne, instantanée grâce à SQLite

C'est le point qui m'a le plus séduit, et il n'a pas bougé. Une fois vos discussions dans la base locale, la recherche se fait entièrement hors ligne. Un simple wacli messages search "réunion" et vous ressortez un vieux message noyé dans la masse, sans même être connecté.

Sous le capot, wacli s'appuie sur la recherche plein texte de SQLite, dans sa version FTS5, avec un repli sur une recherche classique en cas d'indisponibilité. Attention à ce détail si vous compilez vous-même : l'index FTS5 n'est activé que si le binaire a été construit avec le bon indicateur de compilation. Sans lui, la recherche fonctionne toujours, mais en mode dégradé et beaucoup plus lentement sur une grosse base. Les binaires officiels et la formule Homebrew s'en occupent pour vous.

Les filtres sont généreux. Vous pouvez restreindre par discussion, par expéditeur, par sens d'envoi, par période, par type de média, et même ne garder que les messages que WhatsApp a marqués comme favoris ou comme transférés. Les dates acceptent le format simple année-mois-jour. La commande messages export déverse tout ça en JSON dans un fichier, ce qui en fait un point de départ correct pour une archive à long terme.

Un point qui a son importance : la synchronisation ne récupère d'abord que ce que WhatsApp Web envoie spontanément. Pour aller chercher des messages plus anciens, wacli demande à votre téléphone de renvoyer l'historique, ce qui suppose qu'il soit allumé et connecté. La commande history coverage vous dit ce que vous avez déjà en local avant d'aller réclamer le reste.

Envoyer, réagir et gérer ses discussions sans quitter le clavier

wacli ne se contente pas de lire, il écrit aussi. Un wacli send text --to mom --message "j'arrive" suffit pour un message texte, et wacli send file --to maman --file ./photo.jpg pour une pièce jointe. Les destinataires acceptent un numéro de téléphone avec sa mise en forme habituelle, un identifiant JID, ou tout simplement le nom d'un contact, d'un groupe ou d'une discussion déjà synchronisés. Si un nom correspond à plusieurs destinataires, le terminal vous demande de choisir, et l'option --pick permet de trancher d'avance dans un script.

Les commandes wacli que j'utilise au quotidien
Commande Ce qu'elle fait
wacli auth Appairer wacli par QR code ou par numéro, puis lancer la première synchronisation.
wacli sync --follow Maintenir la base locale à jour en continu, sans nouvel appairage.
wacli messages search "…" Chercher hors ligne dans l'intégralité des conversations synchronisées.
wacli messages export Exporter les messages en JSON, avec bornes de dates et filtrage par discussion.
wacli send text Envoyer un message, avec mentions, réponse citée ou mode éphémère.
wacli send file Envoyer un fichier jusqu'à 100 Mio, avec légende et nom d'affichage personnalisables.
wacli send react Réagir à un message, ou retirer une réaction en passant une valeur vide.
wacli doctor Diagnostiquer l'installation : dossier de stockage, intégrité de la base, FTS5, connectivité.
Commandes vérifiées sur la documentation officielle de wacli, version 0.13.0, le 19 août 2026.

Sur les envois, deux comportements m'ont paru bien pensés. D'abord, quand sync --follow tourne déjà et détient le verrou de la base, les commandes d'envoi ne tentent pas d'ouvrir une deuxième session WhatsApp : elles délèguent l'envoi au processus en cours. Vos scripts restent utilisables pendant qu'une synchronisation continue tourne en arrière-plan. Ensuite, un message envoyé n'est pas un message reçu : la confirmation de wacli signifie que WhatsApp a accepté la demande et renvoyé un identifiant, pas que le destinataire l'a reçu. La nuance est explicite dans la documentation, et c'est honnête de le dire.

Sondages, réponses citées et messages retirés ou transférés

Voilà tout un pan que j'avais laissé de côté la première fois, à tort. wacli sait créer des sondages WhatsApp avec wacli send poll, de deux à douze options, en choix unique ou multiple selon le nombre de sélections autorisées. Les sondages reçus pendant la synchronisation sont stockés en local, ce qui permet ensuite de voter avec poll vote, de consulter les résultats agrégés et le détail des votants avec poll show, ou de lister les sondages récents avec polls list.

Côté gestion des messages déjà envoyés, la panoplie s'est bien étoffée :

Les réponses citées ont aussi été fiabilisées dans la 0.13.0 : le contenu du message d'origine, son identifiant technique et son auteur sont désormais correctement reconstruits, y compris quand l'envoi est délégué à une synchronisation en cours. Sur les versions précédentes, les citations partaient parfois amputées.

Enfin, wacli gère les boutons et listes que renvoient les comptes professionnels : la commande send select sélectionne une option d'un message interactif reçu, en la désignant par son libellé, son identifiant ou son rang. La sélection est envoyée comme une réponse citée, pas comme un faux clic simulé, ce qui est un choix technique plus prudent qu'il n'y paraît.

Administrer ses groupes depuis le terminal

C'est l'ajout de la 0.11.1, et il transforme wacli en véritable outil d'administration. La commande groups ne se limite plus à lister et renommer : elle gère désormais l'ensemble du cycle de vie d'un groupe WhatsApp.

Vous pouvez créer un groupe avec ses premiers membres, en le configurant d'emblée en mode annonce, en le verrouillant, ou en activant l'approbation des demandes d'adhésion. Les communautés sont prises en charge, avec la création d'un groupe parent ou d'un sous-groupe rattaché. Sur un groupe existant, groups participants ajoute, retire, promeut ou rétrograde des membres, tandis que groups requests liste, approuve ou rejette les demandes en attente. Le lien d'invitation se récupère et se réinitialise en une commande.

La commande groups prune ne touche qu'à votre base locale : elle supprime des lignes de groupes, discussions et messages sur votre machine, sans quitter le moindre groupe WhatsApp ni effacer quoi que ce soit sur les serveurs de Meta. Utilisez systématiquement le mode simulation avant de confirmer, la liste des cibles réserve parfois des surprises.

Aller plus loin : historique, médias, webhooks et multicompte

Si l'usage de base suffit à la plupart, wacli cache des fonctions qui font la différence quand on veut vraiment industrialiser sa sauvegarde. Voici celles que je garde sous le coude.

Commandes et options avancées
Fonction Commande ou option À quoi ça sert
Complément d'historique history coverage, history fill, history backfill Réclamer discussion par discussion les messages plus anciens auprès du téléphone. Fonctionne au meilleur effort : WhatsApp ne renvoie pas toujours tout.
Récupération des médias media backfill, media retry Télécharger les pièces jointes des messages déjà synchronisés dont seule la fiche descriptive est en local, et rattraper les médias expirés côté serveur en les redemandant au téléphone.
Synchronisation discrète sync --presence-mode quiet Éviter que wacli se signale en ligne en permanence pendant une longue synchronisation, pour que le téléphone continue de recevoir ses notifications normalement.
Webhooks signés sync avec options de webhook Faire suivre les nouveaux messages vers vos propres points d'entrée. Les adresses privées et locales sont bloquées par défaut, une option explicite les autorise pour un usage interne.
Bornes de stockage sync --max-messages, sync --max-db-size Arrêter la synchronisation au-delà d'un nombre de messages ou d'une taille de base, pour ne pas laisser l'archive grossir sans limite.
Statuts et stories wacli send status Publier un statut texte, avec couleur de fond et police, ou un statut média avec légende, directement depuis le terminal.
Multicompte wacli accounts add puis --account Gérer plusieurs identités WhatsApp dans des espaces de stockage, des sessions et des verrous séparés.
Mode lecture seule --read-only ou la variable d'environnement équivalente Refuser toute écriture, côté WhatsApp comme côté base locale. Idéal pour un poste dédié à l'archivage ou une intégration tierce.
Sortie machine --json, --events Obtenir du JSON pour les commandes ponctuelles et un flux d'événements ligne par ligne pour les commandes longues. Les erreurs et la progression restent sur la sortie d'erreur.
Relevé sur la documentation officielle de wacli, version 0.13.0, le 19 août 2026.

Ce mode lecture seule combiné à la sortie JSON est, à mon sens, ce qui rend wacli intéressant au-delà du bidouillage personnel. Vous pouvez brancher un script, une tâche planifiée ou un pipeline de sauvegarde sur la base locale sans risquer qu'une erreur de manipulation aille écrire côté WhatsApp.

Sous le capot : Go, whatsmeow et chiffrement de bout en bout

Côté technique, c'est du Go bâti sur whatsmeow, la bibliothèque de référence qui parle le protocole WhatsApp Web multi-appareils. Conséquence directe : vos messages restent chiffrés de bout en bout pendant leur transport, wacli se comportant comme un appareil lié supplémentaire et non comme un intermédiaire qui casserait le chiffrement.

Une fois arrivées chez vous, en revanche, les données sont en clair dans la base locale. C'est le principe même de l'outil, mais il faut en avoir conscience : si votre disque n'est pas chiffré, votre historique WhatsApp non plus. Le dossier de stockage est créé avec des permissions restreintes, ce qui protège des autres utilisateurs de la machine, pas d'un vol de portable.

Le projet rend d'ailleurs hommage à whatsapp-cli de Vicente Reig, dont il s'inspire largement. Et pour les curieux qui compilent : la génération de la forme d'onde des notes vocales et la détection de leur durée s'appuient sur ffmpeg et ffprobe quand ils sont disponibles sur la machine.

Installer wacli sur macOS, Linux ou Windows

Bonne nouvelle : là où l'outil était surtout pensé pour le Mac à ses débuts, il est aujourd'hui franchement multiplateforme. Le plus simple reste Homebrew, qui fonctionne aussi bien sur macOS que sur Linux. Les archives officielles couvrent les trois systèmes, et la compilation depuis les sources reste possible pour qui veut maîtriser sa chaîne de construction.

Méthodes d'installation et dossier de stockage par défaut
Système Méthode conseillée Autres options Dossier de stockage par défaut
macOS brew install openclaw/tap/wacli Archive officielle, compilation depuis les sources ~/.wacli
Linux brew install openclaw/tap/wacli Archive officielle, compilation depuis les sources ~/.local/state/wacli
Windows Archive officielle depuis les publications GitHub Compilation depuis les sources ~/.wacli
Vérifié sur le guide d'installation officiel le 19 août 2026, pour la version 0.13.0. Le tap Homebrew a changé : l'ancienne adresse personnelle du créateur n'est plus valable.

Si vous suivez un tutoriel antérieur à l'été 2026, la commande Homebrew qu'il indique pointe probablement vers l'ancien tap personnel de Peter Steinberger. Elle ne fonctionne plus. C'est bien openclaw/tap/wacli qu'il faut désormais.

Pour la compilation depuis les sources, il vous faut Go en version 1.26.5 ou supérieure et un compilateur C, puisque wacli utilise une bibliothèque SQLite qui repose sur cgo. Sous macOS, les outils en ligne de commande de Xcode suffisent ; sous Debian ou Ubuntu, le paquet build-essential ; sous Fedora, le groupe d'outils de développement. Et surtout, n'oubliez pas l'indicateur de compilation qui active l'index FTS5, sans quoi votre recherche fonctionnera en mode dégradé.

Quant à Docker, la mention que je faisais dans la version précédente de cet article mérite d'être nuancée. Des images sont bien construites et testées par l'intégration continue du projet, mais le guide d'installation officiel ne documente plus cette voie et ne détaille que Homebrew, les archives et la compilation. Si vous tenez au conteneur, c'est faisable, mais vous serez plus seul que sur les trois autres méthodes.

Bonne nouvelle pour les mises à jour : le format de la base locale est compatible d'une version mineure à l'autre. Un brew upgrade wacli ne vous obligera pas à réappairer votre téléphone ni à resynchroniser tout votre historique.

wacli face aux sauvegardes officielles de WhatsApp

La question que je me poserais à votre place, c'est : pourquoi ne pas se contenter de ce que WhatsApp propose déjà ? Les deux mécanismes officiels existent et fonctionnent, mais ils ne répondent pas au même besoin. Voici comment je les situe les uns par rapport aux autres.

wacli comparé aux solutions officielles de WhatsApp
Critère wacli Export de discussion WhatsApp Sauvegarde Google Drive / iCloud
Statut Outil tiers, non affilié à WhatsApp Fonction officielle Fonction officielle
Où vivent les données Sur votre machine, base SQLite locale Fichier texte et médias, là où vous les envoyez Sur les serveurs de Google ou d'Apple
Recherche hors ligne Oui, plein texte et instantanée Manuelle, dans un fichier texte Non, la sauvegarde n'est pas consultable telle quelle
Portée Toutes les discussions synchronisées, en continu Une discussion à la fois, avec un plafond de messages L'ensemble du compte, mais en bloc opaque
Automatisation Complète : JSON, flux d'événements, webhooks, scripts Aucune, chaque export est manuel Planification simple, sans accès au contenu
Restauration dans l'application Non, ce n'est pas son objet Non Oui, à la réinstallation de l'application
Risque pour le compte Réel, l'outil sort du cadre officiel Nul Nul
Comparatif établi le 19 août 2026. Les plafonds d'export et les modalités de sauvegarde cloud évoluent régulièrement côté WhatsApp.

La conclusion me paraît assez nette : la sauvegarde cloud sert à restaurer, wacli sert à consulter et à exploiter. Ce ne sont pas des concurrents, et rien ne vous empêche de garder la première tout en utilisant le second pour fouiller votre historique.

La mise en garde qui s'impose

Maintenant, la partie où je dois être franc avec vous, et je vais l'être plus fermement que la dernière fois. wacli n'est pas un outil officiel. Il passe par le protocole WhatsApp Web obtenu par rétro-ingénierie, et Meta n'aime pas ça du tout. Le dépôt le dit noir sur blanc dès la première ligne : outil tiers, non affilié à WhatsApp ni à Meta.

Un compte repéré sur ce type d'usage peut être suspendu, et la suspension d'un compte WhatsApp est rarement facile à contester. Réservez wacli à votre propre compte, pour un usage personnel et mesuré. Aucun envoi automatisé en volume, aucune prospection, aucune manipulation sur un compte qui ne vous appartient pas. Le risque n'est pas théorique, et personne ne le portera à votre place.

Les développeurs ont d'ailleurs intégré un garde-fou révélateur : si vous enchaînez plusieurs envois dans un intervalle de quelques secondes, wacli affiche un avertissement sur la sortie d'erreur. L'idée est de rendre visible, dans vos propres scripts, le moment où vous commencez à ressembler à un robot aux yeux de WhatsApp. C'est le genre de détail qui trahit un projet conçu par des gens qui ont réfléchi aux conséquences, mais ça ne vous dispense pas de votre part de prudence.

Mon verdict

Pour qui veut reprendre la main sur ses données, wacli reste pile le genre d'outil que j'apprécie : sobre, scriptable, respectueux du chiffrement en transit et entièrement local. La montée en version de ces dernières semaines l'a rendu franchement plus complet, avec l'administration de groupe, la récupération des médias manquants et une compatibilité protocole remise à niveau à deux reprises.

Ce n'est pas un outil pour tout le monde, et je ne vais pas prétendre le contraire. Si le terminal vous effraie, passez votre chemin, il n'existe aucune interface graphique et rien n'indique qu'il en existera une. Mais si vous êtes à l'aise en ligne de commande et que l'idée de posséder pour de bon vos conversations vous parle, testez-le. En prenant la dernière version, et en gardant en tête la mise en garde ci-dessus.

Questions fréquentes

Quelle version de wacli faut-il installer ?
La plus récente, la 0.13.0 au 19 août 2026. Toute version antérieure à la 0.11.2 échoue à se connecter avec une erreur 405 (Client Outdated), WhatsApp ayant fait évoluer son protocole entre-temps.
wacli est-il gratuit et open source ?
Oui. Le projet est publié sous licence MIT, ce qui vous laisse libre de l'utiliser, de le modifier et de le redistribuer.
Mes messages restent-ils chiffrés ?
Pendant leur transport, oui : wacli se connecte comme un appareil lié via whatsmeow et le chiffrement de bout en bout est préservé. Une fois arrivés chez vous, en revanche, vos messages sont stockés en clair dans une base SQLite locale. Si la confidentialité de votre disque vous préoccupe, chiffrez-le.
Fonctionne-t-il sur Windows et Linux, ou seulement sur Mac ?
Sur les trois. Des binaires officiels existent pour macOS, Linux et Windows, et Homebrew fonctionne sur macOS comme sur Linux. La 0.13.0 a d'ailleurs corrigé plusieurs problèmes de chemins spécifiques à Windows.
Est-ce que je risque de faire suspendre mon compte ?
C'est un risque réel. wacli est un outil tiers non affilié à WhatsApp, qui s'appuie sur du protocole obtenu par rétro-ingénierie. Un usage personnel et modéré limite le risque, mais rien n'est garanti.
Puis-je récupérer d'anciens messages ?
En partie. La synchronisation attrape ce que WhatsApp Web envoie spontanément, et les commandes de complément d'historique réclament les messages plus anciens à votre téléphone, qui doit être allumé et connecté. La récupération reste au meilleur effort, WhatsApp ne renvoyant pas systématiquement tout.
Puis-je l'utiliser avec plusieurs comptes WhatsApp ?
Oui. La commande de gestion des comptes crée des espaces séparés, chacun avec sa propre session, sa propre base et son propre verrou. Vous basculez de l'un à l'autre avec une option en ligne de commande.
Peut-on l'utiliser sans jamais rien écrire côté WhatsApp ?
Oui, c'est même prévu. Un mode lecture seule refuse toute écriture, aussi bien vers WhatsApp que vers la base locale. C'est ce que j'utiliserais sur une machine dédiée à l'archivage.

Article rédigé par David pour David Informaticien.

Source