WhatsApp est là où les conversations ont lieu. Pas Slack, pas Discord, pas Telegram — pour la majeure partie du monde, WhatsApp est le choix par défaut. Deux milliards d'utilisateurs actifs mensuels, dominant en Europe, en Amérique latine, en Asie du Sud et en Afrique. Si vous voulez un assistant IA qui fasse réellement partie de votre quotidien, il doit être là où vos conversations quotidiennes ont déjà lieu.
Le problème est que WhatsApp ne propose pas d'API de bot pour les particuliers. L'API WhatsApp Business existe, mais elle nécessite un compte professionnel, l'approbation de Meta et une structure tarifaire au message conçue pour le service client, pas pour les assistants personnels. Pour un développeur qui veut un bot IA personnel dans son WhatsApp — un qui répond dans les conversations de groupe, se souvient du contexte et tourne sur son propre matériel — la voie officielle est une impasse.
NanoClaw résout cela avec Baileys, une bibliothèque open source WhatsApp Web qui se connecte aux serveurs de WhatsApp de la même manière que le client WhatsApp Web. Vous scannez un QR code, la connexion est établie, et NanoClaw peut envoyer et recevoir des messages via votre compte WhatsApp. Pas d'API Business, pas d'approbation Meta, pas de frais au message.
L'architecture : pourquoi WhatsApp est spécial
L'intégration WhatsApp de NanoClaw n'est pas un simple pont de messages — c'est le canal principal autour duquel toute l'architecture est conçue. Alors que les autres canaux (Telegram, Discord, Slack) sont ajoutés via des skills Claude Code, WhatsApp est intégré au cœur. Ce n'est pas du favoritisme ; c'est le reflet de la façon dont le modèle de groupes de WhatsApp correspond naturellement au modèle de sécurité de NanoClaw.
Les groupes WhatsApp sont la frontière d'isolation. Chaque groupe obtient son propre conteneur, son propre fichier mémoire CLAUDE.md et son propre espace de travail en écriture. Quand quelqu'un envoie un message dans un groupe familial, l'agent qui répond n'a accès qu'à l'historique et à la mémoire de ce groupe. Il ne peut pas voir les messages de votre groupe de travail, ne peut pas accéder à votre historique de chat privé et ne peut pas lire les fichiers appartenant à d'autres groupes. L'isolation est assurée par les montages de conteneur, pas par la logique applicative.
Cette isolation par groupe est ce qui rend NanoClaw sûr pour la façon dont les gens utilisent réellement WhatsApp. Votre groupe familial discute de sujets personnels. Votre groupe de travail discute de projets propriétaires. Votre groupe d'amis partage des choses qu'ils ne partageraient pas publiquement. Chacun de ces contextes doit être séparé, et NanoClaw s'en assure — non pas via des listes de contrôle d'accès qui pourraient avoir des bugs, mais via une séparation physique par conteneur qui ne peut pas être contournée par des exploits au niveau applicatif. ## Mise en place
Le processus d'installation prend environ dix minutes, dont la majeure partie est l'attente de npm install.
Clonez le dépôt et installez les dépendances :
```bash git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw npm install ```
Configurez votre environnement. La configuration minimale viable est juste une clé API Anthropic :
```bash echo 'ANTHROPIC_API_KEY=sk-ant-your-key-here' > .env ```
Lancez l'appairage WhatsApp :
```bash npm run auth ```
Cela affiche un QR code dans votre terminal. Ouvrez WhatsApp sur votre téléphone, allez dans Appareils connectés et scannez le code. La connexion est établie, et NanoClaw écoute désormais les messages.
Démarrez l'agent :
```bash npm start ```
C'est tout. Envoyez un message dans n'importe quel groupe WhatsApp où vous voulez que le bot soit actif, mentionnez le nom de l'assistant (configurable via ASSISTANT_NAME dans .env), et il répond. La première réponse prend quelques secondes le temps que le conteneur démarre ; les messages suivants dans la même session sont plus rapides car le conteneur reste chaud.
Comment les messages circulent
Comprendre le flux des messages aide à expliquer pourquoi NanoClaw semble réactif malgré le surcoût des conteneurs. Quand un message arrive sur WhatsApp, le processus hôte — le cœur TypeScript d'environ 500 lignes de NanoClaw — le reçoit via Baileys. Il vérifie si le message est adressé à l'assistant (par mention du nom ou message direct). Si c'est le cas, l'hôte consulte l'état du conteneur du groupe.
Si un conteneur tourne déjà pour ce groupe (suite à une conversation récente), le message lui est routé via IPC. L'agent à l'intérieur du conteneur reçoit le message, le traite avec Claude Agent SDK et renvoie la réponse via IPC. L'hôte transmet la réponse à WhatsApp. Latence ajoutée totale : quelques millisecondes pour l'IPC, plus le temps de réponse de l'API Claude.
Si aucun conteneur ne tourne, l'hôte en lance un. Sur macOS avec Apple Container, cela prend 200 à 400 ms. Sur Linux avec Docker, 1 à 2 secondes. Le conteneur reçoit le fichier mémoire CLAUDE.md du groupe, l'historique de conversation depuis SQLite et la clé API via stdin. Il traite le message et répond. Le conteneur reste actif pendant un délai configurable (par défaut : 30 minutes) pour gérer les messages de suivi sans le surcoût de lancement.
Le résultat est que la plupart des messages — ceux qui arrivent pendant une conversation active — semblent instantanés. Le temps de réponse de l'IA est dominé par la latence de l'API Claude, pas par l'infrastructure de NanoClaw. Seul le premier message après un long silence a le surcoût de démarrage du conteneur, et même celui-ci est suffisamment rapide pour que les utilisateurs le remarquent rarement. ## La mémoire par groupe : la fonctionnalité qui le rend utile
Le fichier CLAUDE.md par groupe est ce qui transforme un chatbot sans état en un assistant réellement utile. Le fichier mémoire de chaque groupe accumule du contexte au fil du temps — préférences, projets en cours, sujets récurrents, blagues internes. L'agent lit ce fichier au début de chaque tour de conversation, ce qui signifie qu'il se souvient de ce que vous lui avez dit la semaine dernière sans que vous ayez à le répéter.
Dans un groupe familial, la mémoire peut noter les préférences alimentaires, les emplois du temps scolaires et les activités récurrentes. Dans un groupe de travail, elle peut suivre les échéances de projet, les préférences de l'équipe et les décisions techniques. Dans un groupe d'amis, elle peut retenir les plans de voyage, les recommandations de restaurants et les centres d'intérêt partagés.
La mémoire est modifiable. Vous pouvez demander à l'agent de retenir quelque chose de spécifique (« retiens que maman est allergique aux fruits de mer ») ou d'oublier quelque chose (« oublie ce que j'ai dit sur la fête surprise »). Vous pouvez aussi éditer le fichier CLAUDE.md directement — c'est un fichier texte brut sur votre système de fichiers, pas enfermé dans une base de données.
La réalité en matière de vie privée
Faire tourner un bot IA WhatsApp soulève des questions légitimes de vie privée, et il vaut la peine d'être direct à ce sujet. Les messages que NanoClaw traite sont envoyés à l'API d'Anthropic pour que Claude génère des réponses. Cela signifie que vos messages WhatsApp — ou du moins ceux adressés à l'assistant — quittent votre appareil et sont traités par les serveurs d'Anthropic.
NanoClaw atténue cela de plusieurs manières. Seuls les messages explicitement adressés à l'assistant sont envoyés à l'API — le bot ne traite ni ne stocke les messages qui ne lui sont pas destinés. L'historique de conversation stocké dans SQLite reste sur votre machine. Les fichiers mémoire CLAUDE.md restent sur votre machine. Et si vous configurez NanoClaw pour utiliser Ollama au lieu d'Anthropic, le traitement IA se fait localement aussi — rien ne quitte votre réseau.
Pour la plupart des utilisateurs, la posture pratique en matière de vie privée est : vos messages WhatsApp restent sur votre appareil sauf quand vous posez explicitement une question à l'assistant IA, auquel cas ce message spécifique est envoyé à Anthropic (ou traité localement avec Ollama). C'est une histoire de vie privée sensiblement meilleure que les services d'IA cloud qui traitent et stockent tout ce que vous tapez.
WhatsApp est là où votre vie se passe. NanoClaw y place un assistant IA — avec l'isolation, la mémoire et le modèle de vie privée qui le rendent sûr à utiliser dans les groupes où vous discutez de choses qui comptent vraiment.