NanoClaw : Assistant IA WhatsApp léger et sécurisé propulsé par Claude

NanoClaw est un projet hobby open‑source qui vous permet de transformer votre téléphone en assistant personnel alimenté par Claude, tout en gardant vos données isolées dans des conteneurs Docker ou Apple Container. Il a été conçu comme une alternative plus simple et plus compréhensible à Clawdbot / OpenClaw, avec un accent sur le minimalisme, la sécurité et la personnalisation contrôlée par l’utilisateur.

Pourquoi NanoClaw ?

Tout cela se combine pour offrir un projet que vous pouvez forker, comprendre en dix minutes et déployer sans aucun « assistant d'installation ».

Guide de démarrage rapide

1. Cloner le dépôt

   git clone https://github.com/qwibitai/nanoclaw.git
   cd nanoclaw
   

2. Exécuter le script de bootstrap

   claude          # première fois : installation des dépendances, demande de votre clé API Anthropic, code QR WhatsApp, etc.
   /setup          # configure automatiquement Docker/AppleContainer et installe les modules requis
   

3. Lancer le bot

   /run
   

4. Commencer la conversation – Scannez le QR dans le terminal avec votre téléphone, puis dites @Andy (ou changez le mot déclencheur) pour parler.

Suivez les invites à l'écran et vos messages WhatsApp deviendront des commandes pour Claude. L'assistant conserve le contexte de conversation dans un fichier CLAUDE.md par groupe, afin que les messages ultérieurs continuent là où vous vous êtes arrêté.

Étendre NanoClaw avec des compétences

NanoClaw introduit un système de compétences déterministe. Au lieu d’ajouter directement de nouvelles fonctionnalités, vous écrivez une compétence qui transforme la base de code actuelle en la version souhaitée. Par exemple, ajouter la prise en charge de Telegram est aussi simple que :

npm run skills:init -- --core-version 0.5.0 --base-source .
npm run skills:apply -- --skill telegram --version 1.2.0 --files-modified src/server.ts

Ensuite exécutez /add-telegram et vous obtiendrez un canal Telegram propre et séparé sans tout ce désordre supplémentaire.

Liste d'exemples de compétences

Seules les mises à jour du cœur, les corrections de bugs ou les améliorations de sécurité arrivent dans le dépôt de base ; tout le reste réside dans les compétences. Cela maintient le cœur propre tout en vous offrant une extensibilité.

Modèle de sécurité

La sécurité de NanoClaw repose sur deux couches :

1. Contrôles au niveau de l’application – Les codes d’appairage et les listes d’accès protègent votre connexion WhatsApp.
2. Isolation des conteneurs – Chaque agent vit dans un bac à sable avec uniquement les répertoires que vous montez. Bash s'exécute à l'intérieur du conteneur, pas sur votre hôte.

Le fichier SECURITY.md du dépôt décrit le modèle en détail et comment auditer ce qui est monté dans chaque conteneur.

Questions fréquentes

Pourquoi ne pas exécuter uniquement sur l'hôte ? L'environnement d'exécution peut être puissant, mais toute faille pourrait compromettre vos informations personnelles. Les conteneurs offrent une frontière stricte.

Puis-je exécuter sur Linux ? Oui — Docker est le défaut sur Linux, et le script /setup configure tout automatiquement.

Que se passe-t-il si le planificateur s'arrête ? Demandez à Claude : Why isn't the scheduler running? Grâce au harness natif de Claude, le débogage se fait simplement via chat.

Impliquez‑vous

NanoClaw est ouvert aux contributions. Si vous souhaitez ajouter de nouveaux types de compétences ou améliorer le cœur, ouvrez une PR avec une documentation claire dans les fichiers de compétences CLAUDE.md.

• Forkez le dépôt
• Créez un dossier de compétences sous .claude/skills/
• Écrivez un SKILL.md qui indique à Claude comment transformer le code actuel
• Exécutez la compétence localement avec npm run skills:apply
• Testez les modifications, puis soumettez une PR

Bon hacking — et que vos agents se rassemble sans heurts !