Questions fréquentes
Questions courantes sur NanoClaw et son fonctionnement.
NanoClaw est un assistant IA personnel léger et open source construit sur le Claude Agent SDK d'Anthropic. Les agents s'exécutent dans des conteneurs Linux isolés (Apple Container sur macOS, Docker sur macOS/Linux). WhatsApp intégré, autres canaux via les compétences. Mémoire persistante SQLite, tâches planifiées, accès web, automatisation du navigateur et essaims d'agents.
Exécutez 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' et utilisez /setup dans la session Claude. Claude Code gère les dépendances, l'authentification, la configuration des conteneurs et du service. Nécessite Node.js 20+ et Claude Code.
NanoClaw est assez petit pour être compris — un seul processus, quelques fichiers source, aucun microservice. Contrairement aux usines à gaz, vous pouvez lire l'intégralité du code. Les agents s'exécutent dans de vrais conteneurs Linux avec isolation du système de fichiers, pas derrière des vérifications de permissions applicatives.
NanoClaw fonctionne exclusivement avec le Claude Agent SDK d'Anthropic. Claude Code est installé globalement dans chaque conteneur et gère toutes les interactions IA. Le SDK gère la sélection du modèle en interne — NanoClaw est mono-fournisseur par conception.
WhatsApp est le canal intégré (via la bibliothèque Baileys, appairage par QR code). Telegram, Discord et Slack peuvent être ajoutés via les compétences Claude Code — exécutez /add-telegram, /add-discord ou /add-slack. Les compétences modifient le code source de votre fork pour ajouter une prise en charge propre et dédiée du canal.
La sécurité est un principe de conception fondamental. Les agents s'exécutent dans des conteneurs Linux (Apple Container sur macOS, Docker sur macOS/Linux) avec isolation du système de fichiers — pas derrière des vérifications de permissions applicatives. Les secrets sont transmis via stdin JSON et jamais chargés dans process.env. Listes d'autorisation de montage avec détection d'évasion par liens symboliques. Les conteneurs s'exécutent en tant qu'utilisateur non-root avec montage en lecture seule du projet.
NanoClaw utilise SQLite (better-sqlite3) pour le stockage persistant — messages, groupes, sessions, tâches planifiées et état du routeur. Chaque groupe dispose aussi de son propre fichier CLAUDE.md pour la mémoire par groupe, monté dans son conteneur. Aucune base de données externe nécessaire.
Oui. NanoClaw fonctionne sur macOS et Linux — partout où Node.js 20+ et Docker fonctionnent. Le noyau léger en TypeScript fonctionne sur des appareils à faibles ressources, y compris le Raspberry Pi. Nécessite un environnement d'exécution de conteneurs (Apple Container ou Docker) et une clé API Anthropic.
Les essaims d'agents permettent à NanoClaw de lancer des équipes d'agents spécialisés qui collaborent sur des tâches complexes. NanoClaw est le premier assistant IA personnel à prendre en charge les essaims d'agents, construit sur la fonctionnalité agent-teams de Claude Code.
Le projet est open source sous licence MIT sur github.com/qwibitai/nanoclaw. Consultez le README pour les directives de contribution. Toutes les contributions sont les bienvenues.
Les outils intégrés sont fournis par Claude Code s'exécutant dans les conteneurs : commandes shell, lecture/écriture de fichiers, recherche web, navigation web (Chromium) et délégation d'agents (essaims). Le processus hôte fournit les tâches planifiées (cron), la mémoire persistante SQLite et la messagerie WhatsApp. Étendez les fonctionnalités en ajoutant des compétences.
Oui. Chaque conteneur d'agent dispose de Chromium et agent-browser pour l'automatisation du navigateur. Claude Code peut effectuer des recherches web et parcourir des pages pour obtenir des informations en temps réel dans le conteneur isolé.
Le dépôt officiel et seul dépôt de confiance est github.com/qwibitai/nanoclaw. Le Discord de la communauté est discord.gg/VDdww8qS42.
macOS et Linux. Nécessite Node.js 20+ et un environnement d'exécution de conteneurs — Apple Container sur macOS ou Docker sur macOS/Linux. Windows n'est pas officiellement pris en charge mais peut fonctionner via WSL2 avec Docker.
NanoClaw utilise exclusivement Anthropic Claude via le Claude Agent SDK. Définissez ANTHROPIC_API_KEY dans votre fichier .env, ou authentifiez-vous via Claude Code OAuth. Il n'y a pas de prise en charge multi-fournisseur — le SDK gère la sélection du modèle en interne.
Le README du dépôt GitHub (github.com/qwibitai/nanoclaw) est la source principale de documentation. Le répertoire docs/ contient les spécifications d'architecture, le modèle de sécurité et la liste de vérification de débogage. Le code est assez petit pour que vous puissiez demander à Claude Code de vous le présenter.
Canaux officiels : Discord (discord.gg/VDdww8qS42) et GitHub (github.com/qwibitai/nanoclaw). Consultez le README pour tous les liens communautaires.