NanoClaw

Votre agent IA personnel. Sécurisé. Léger. Le vôtre.

NanoClaw s'exécute en toute sécurité dans des conteneurs, conçu pour être compris et personnalisé selon vos besoins.

étoiles sur GitHub

Pourquoi NanoClaw ?

NanoClaw offre les mêmes fonctionnalités essentielles dans un code que vous pouvez réellement comprendre.

NanoClaw
OpenClaw
Fichiers source 15 3 680
Lignes de code ~3 900 434 453
Dépendances <10 70
Fichiers de configuration 0 53
Temps pour comprendre 8 minutes 1 à 2 semaines
Modèle de sécurité Isolation par conteneurs du système Vérifications au niveau applicatif
Architecture Processus unique + conteneurs isolés Processus unique, mémoire partagée

Fonctionnalités incluses

Tout ce que NanoClaw propose nativement, et rien de superflu.

💬

Applications de messagerie

WhatsApp, Telegram et plus encore. Envoyez des messages à votre agent NanoClaw depuis votre téléphone via les apps que vous utilisez déjà.

🔒

Isolation par conteneurs

Les agents s'exécutent dans Apple Container (macOS) ou Docker. Ils ne peuvent voir que ce que vous montez explicitement.

🐝

Essaims d'agents NOUVEAU

NanoClaw peut créer des équipes d'agents spécialisés qui collaborent sur des tâches complexes. La première IA personnelle à le proposer.

🧠

Mémoire par groupe

Chaque groupe possède sa propre mémoire CLAUDE.md, son propre système de fichiers isolé, et s'exécute dans son propre conteneur.

Tâches planifiées

Des tâches récurrentes qui exécutent Claude et vous renvoient la réponse. Briefings matinaux, bilans hebdomadaires et plus encore.

🧩

Système de skills

Étendez les fonctionnalités sans alourdir le système. Ajoutez Gmail, Telegram ou des capacités personnalisées via les skills.

Configuration native IA

Pas d'assistant d'installation. Claude Code guide tout : dépendances, authentification, conteneurs, services.

🌐

Accès web

NanoClaw peut chercher sur le web, récupérer du contenu et parcourir des pages pour effectuer des recherches.

Architecture

NanoClaw est un processus Node.js unique. Des agents dans des conteneurs isolés. 15 fichiers source.

Message entrant
WhatsApp / Telegram
SQLite
stocker et dédupliquer
File de groupe
FIFO par groupe
Conteneur
Claude Agent SDK
Réponse
transmise en streaming

Processus unique

Un seul processus Node.js interroge les messages, gère les files d'attente, lance les conteneurs et gère l'IPC. Pas de microservices, pas de brokers de messages.

Isolation par groupe

Chaque groupe obtient son propre conteneur, système de fichiers, espace de noms IPC et session Claude. Les groupes ne peuvent pas accéder aux données des autres groupes.

Contrôle de la concurrence

GroupQueue limite les conteneurs simultanés (par défaut : 3). Ordre FIFO par groupe avec nouvelles tentatives en cas d'échec selon un backoff exponentiel.

IPC via le système de fichiers

Les conteneurs communiquent avec l'hôte via des fichiers JSON dans des répertoires par groupe. L'hôte interroge, valide l'autorisation, exécute et nettoie.

Fichiers clés

index.ts — Orchestrateur — boucle d'interrogation, traitement des messages, invocation des agents
container-runner.ts — Lance les conteneurs avec des montages isolés, transmet la sortie en streaming
group-queue.ts — File FIFO par groupe avec limites de concurrence et backoff pour les tentatives
ipc.ts — Traite les requêtes IPC des conteneurs avec vérification des autorisations
db.ts — SQLite — messages, sessions, groupes, tâches, état du routeur
task-scheduler.ts — Exécution de tâches planifiées avec cron, intervalles et exécution unique

Philosophie

Les principes qui guident chaque décision dans NanoClaw.

🔍

Assez petit pour être compris

NanoClaw est un processus unique et une poignée de fichiers source. Assez petit pour que vous puissiez lire et comprendre l'intégralité du code.

🛡️

Sécurisé par l'isolation

Les agents s'exécutent dans des conteneurs Linux. Ils ne peuvent voir que ce qui est explicitement monté. Bash est sûr car il s'exécute à l'intérieur du conteneur.

👤

Conçu pour un seul utilisateur

NanoClaw n'est pas un framework monolithique. C'est un logiciel fonctionnel qui s'adapte à vos besoins exacts. Forkez-le, laissez Claude Code l'adapter pour vous.

🤖

Natif IA

Pas d'assistant d'installation ; Claude Code guide la configuration. Pas de tableau de bord ; demandez à Claude. Pas d'outils de débogage ; décrivez le problème.

🧩

Des skills plutôt que des fonctionnalités

Les contributeurs ajoutent des skills Claude Code comme /add-telegram qui transforment votre installation. Vous obtenez un code propre qui fait exactement ce dont vous avez besoin.

Le meilleur environnement, le meilleur modèle

S'exécute sur Claude Agent SDK, ce qui signifie que vous exécutez Claude Code directement. L'environnement d'exécution compte. Un bon environnement donne des superpouvoirs aux modèles intelligents.

Démarrez avec NanoClaw en 3 lignes

Clonez NanoClaw, entrez dans le répertoire et laissez Claude gérer le reste.

Terminal
$ git clone https://github.com/qwibitai/nanoclaw.git
$ cd nanoclaw
$ claude

Puis exécutez /setup Claude Code gère tout : dépendances, authentification, configuration des conteneurs, configuration des services.

Prérequis

macOS ou Linux Node.js 20+ Claude Code Apple Container (macOS) ou Docker

Dans la presse

FAQ

En quoi NanoClaw est-il différent d'OpenClaw ?

NanoClaw (également connu sous le nom de Nano Claw) adopte une approche fondamentalement différente. Là où OpenClaw est un framework à grande échelle avec des milliers de fichiers source et des dizaines de dépendances, NanoClaw est un agent IA personnel léger construit autour de 15 fichiers source que vous pouvez lire et comprendre en une seule session. NanoClaw utilise l'isolation par conteneurs au niveau du système d'exploitation (Docker ou Apple Container) pour isoler chaque session d'agent, au lieu de s'appuyer sur des vérifications de permissions au niveau applicatif. Si vous cherchez une alternative sécurisée et minimale à OpenClaw que vous pouvez entièrement auditer et personnaliser, NanoClaw est conçu exactement pour cela.

NanoClaw est-il sécurisé ?

La sécurité est un principe de conception fondamental. Chaque session d'agent s'exécute dans un conteneur Linux isolé avec son propre système de fichiers, espace de noms IPC et espace de processus. Les agents ne peuvent accéder qu'aux répertoires explicitement montés, et il n'y a aucun accès implicite à votre système. Comme l'intégralité du code représente environ 3 900 lignes réparties sur 15 fichiers, vous pouvez réellement auditer tout ce que fait le logiciel. Cette combinaison d'isolation au niveau des conteneurs et d'un code compact et auditable fait de NanoClaw l'un des moyens les plus transparents et sécurisés d'exécuter des agents IA.

Quelles applications de messagerie NanoClaw prend-il en charge ?

NanoClaw inclut nativement la prise en charge de WhatsApp et peut être étendu pour fonctionner avec Telegram, le courrier électronique et d'autres canaux via le système de skills. Ajouter Telegram est aussi simple que d'exécuter le skill /add-telegram, qui vous guide à travers toute la configuration. L'architecture est conçue de sorte que les canaux de messagerie soient modulaires, vous pouvez donc en exécuter un ou plusieurs en parallèle, chacun avec sa propre configuration.

Quels environnements d'exécution de conteneurs sont pris en charge ?

NanoClaw prend en charge Apple Container et Docker. Sur macOS, Apple Container offre un sandboxing rapide et léger optimisé pour Apple silicon, tandis que Docker est disponible comme alternative. Sur Linux, Docker est utilisé automatiquement. Lors du processus initial de /setup, vous choisissez l'environnement à utiliser selon votre plateforme et vos préférences.

Puis-je exécuter NanoClaw sur Linux ?

Oui. NanoClaw fonctionne sur macOS et Linux. Sur Linux, Docker est utilisé comme environnement d'exécution de conteneurs et est configuré automatiquement lors de l'installation. Les prérequis système sont Node.js 20 ou ultérieur, Claude Code et un environnement de conteneurs (Docker sur Linux). Le skill /setup gère toutes les vérifications de dépendances et la configuration pour votre plateforme.

Comment installer et configurer NanoClaw ?

NanoClaw utilise un processus de configuration natif IA. Après avoir cloné le dépôt et lancé Claude Code, vous exécutez le skill /setup qui vous guide pour installer les dépendances, authentifier vos canaux de messagerie, configurer votre environnement de conteneurs et démarrer les services en arrière-plan. Il n'y a aucun fichier de configuration à modifier manuellement. Claude Code gère toute la configuration de manière interactive. Pour les modifications ultérieures, décrivez ce que vous souhaitez et Claude Code effectuera les changements directement dans le code.

Comment NanoClaw se compare-t-il aux autres frameworks d'agents IA ?

La plupart des frameworks d'agents IA sont conçus pour des équipes qui développent des produits. Ils sont volumineux, complexes et nécessitent un investissement important pour être compris. NanoClaw est conçu pour les personnes qui veulent un assistant IA personnel qu'ils possèdent et contrôlent entièrement. Il s'exécute comme un processus Node.js unique, utilise une véritable isolation par conteneurs plutôt qu'un sandboxing au niveau applicatif, et est assez petit pour être compris dans son intégralité. Il s'exécute sur Claude Agent SDK, vous donnant un accès direct aux capacités de Claude sans couches d'abstraction.

NanoClaw est-il open source ?

Oui. Nano Claw est entièrement open source sous la licence MIT. L'intégralité du code est disponible sur GitHub et les contributions sont les bienvenues. Le projet encourage le fork et la personnalisation. La philosophie est que votre agent IA personnel doit être un logiciel fonctionnel adapté à vos besoins exacts, pas un framework générique que vous configurez.