NanoClaw

Jouw persoonlijke AI-agent. Veilig. Lichtgewicht. Van jou.

NanoClaw draait veilig in containers, gebouwd om begrepen en aangepast te worden aan jouw behoeften.

sterren op GitHub

Waarom NanoClaw?

NanoClaw biedt dezelfde kernfunctionaliteit in een codebase die je daadwerkelijk kunt begrijpen.

NanoClaw
OpenClaw
Bronbestanden 15 3.680
Regels code ~3.900 434.453
Afhankelijkheden <10 70
Configuratiebestanden 0 53
Tijd om te begrijpen 8 minuten 1–2 weken
Beveiligingsmodel OS-containerisolatie Controles op applicatieniveau
Architectuur Enkel proces + geïsoleerde containers Enkel proces, gedeeld geheugen

Wat Het Ondersteunt

Alles wat NanoClaw standaard ondersteunt, en niets wat je niet nodig hebt.

💬

Berichten-apps

WhatsApp, Telegram en meer. Stuur berichten naar je NanoClaw-agent vanaf je telefoon via de apps die je al gebruikt.

🔒

Containerisolatie

Agenten draaien in Apple Container (macOS) of Docker. Ze kunnen alleen zien wat je expliciet mount.

🐝

Agentzwermen NIEUW

NanoClaw kan teams van gespecialiseerde agenten opzetten die samenwerken aan complexe taken. De eerste persoonlijke AI die dit ondersteunt.

🧠

Geheugen Per Groep

Elke groep heeft zijn eigen CLAUDE.md-geheugen, geïsoleerd bestandssysteem en draait in zijn eigen container-sandbox.

Geplande Taken

Terugkerende taken die Claude uitvoeren en je het antwoord sturen. Ochtendbriefings, wekelijkse overzichten en meer.

🧩

Skillssysteem

Breid functionaliteit uit zonder opgeblazen code. Voeg Gmail, Telegram of aangepaste mogelijkheden toe via skills.

AI-Natieve Configuratie

Geen installatiewizards. Claude Code begeleidt alles: afhankelijkheden, authenticatie, containers, services.

🌐

Webtoegang

NanoClaw kan het web doorzoeken, inhoud ophalen en pagina's bekijken om alles te onderzoeken.

Architectuur

NanoClaw is een enkel Node.js-proces. Agenten in geïsoleerde containers. 15 bronbestanden.

Inkomend Bericht
WhatsApp / Telegram
SQLite
opslaan en dedupliceren
Groepswachtrij
FIFO per groep
Container
Claude Agent SDK
Antwoord
teruggestreamd

Enkel Proces

Een Node.js-proces pollt berichten, beheert wachtrijen, start containers en verwerkt IPC. Geen microservices, geen message brokers.

Isolatie Per Groep

Elke groep krijgt zijn eigen container, bestandssysteem, IPC-namespace en Claude-sessie. Groepen hebben geen toegang tot gegevens van andere groepen.

Concurrentiebeheer

GroupQueue beperkt gelijktijdige containers (standaard: 3). FIFO-volgorde per groep met herhaalpogingen bij fouten met exponentiële backoff.

IPC via Bestandssysteem

Containers communiceren met de host via JSON-bestanden in mappen per groep. De host pollt, valideert autorisatie, voert uit en ruimt op.

Belangrijke Bestanden

index.ts — Orchestrator — pollingcyclus, berichtverwerking, agentaanroep
container-runner.ts — Start containers met geïsoleerde mounts, streamt uitvoer
group-queue.ts — FIFO-wachtrij per groep met concurrentielimieten en backoff bij herhaalpogingen
ipc.ts — Verwerkt container-IPC-verzoeken met autorisatiecontroles
db.ts — SQLite — berichten, sessies, groepen, taken, routerstatus
task-scheduler.ts — Uitvoering van geplande taken via cron, interval en eenmalige uitvoering

Filosofie

De principes die elke NanoClaw-beslissing vormgeven.

🔍

Klein genoeg om te begrijpen

NanoClaw is een proces, een handvol bronbestanden. Klein genoeg zodat je de hele codebase kunt lezen en begrijpen.

🛡️

Veilig door isolatie

Agenten draaien in Linux-containers. Ze kunnen alleen zien wat expliciet gemount is. Bash is veilig omdat het binnen de container draait.

👤

Gebouwd voor een gebruiker

NanoClaw is geen monolithisch framework. Het is werkende software die past bij jouw exacte behoeften. Fork het, laat Claude Code het aanpassen aan jouw wensen.

🤖

AI-natief

Geen installatiewizard; Claude Code begeleidt de configuratie. Geen dashboard; vraag het aan Claude. Geen debugtools; beschrijf het probleem.

🧩

Skills boven functies

Bijdragers voegen Claude Code-skills toe zoals /add-telegram die je installatie transformeren. Je eindigt met schone code die precies doet wat je nodig hebt.

Beste harness, beste model

Draait op Claude Agent SDK, wat betekent dat je Claude Code direct uitvoert. De harness doet ertoe. Een goede geeft slimme modellen superkrachten.

Begin met NanoClaw in 3 Regels

Kloon NanoClaw, ga naar de map en laat Claude de rest doen.

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

Voer dan uit /setup Claude Code regelt alles: afhankelijkheden, authenticatie, containerconfiguratie, serviceconfiguratie.

Vereisten

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

In het Nieuws

FAQ

Hoe verschilt NanoClaw van OpenClaw?

NanoClaw (ook bekend als Nano Claw) hanteert een fundamenteel andere aanpak. Waar OpenClaw een grootschalig framework is met duizenden bronbestanden en tientallen afhankelijkheden, is NanoClaw een lichtgewicht persoonlijke AI-agent gebouwd rond 15 bronbestanden die je in een sessie kunt lezen en begrijpen. NanoClaw gebruikt containerisolatie op OS-niveau (Docker of Apple Container) om elke agentsessie te sandboxen, in plaats van te vertrouwen op permissiecontroles op applicatieniveau. Als je op zoek bent naar een veilig, minimaal alternatief voor OpenClaw dat je volledig kunt auditen en aanpassen, dan is NanoClaw precies daarvoor ontworpen.

Is NanoClaw veilig?

Beveiliging is een kernprincipe van het ontwerp. Elke agentsessie draait in een geïsoleerde Linux-container met een eigen bestandssysteem, IPC-namespace en procesruimte. Agenten hebben alleen toegang tot mappen die expliciet gemount zijn, en er is geen impliciete toegang tot je systeem. Omdat de volledige codebase ongeveer 3.900 regels code in 15 bestanden is, kun je realistisch gezien alles auditen wat de software doet. Deze combinatie van isolatie op containerniveau en een kleine, auditbare codebase maakt NanoClaw een van de meest transparante en veilige manieren om AI-agenten uit te voeren.

Welke berichten-apps ondersteunt NanoClaw?

NanoClaw wordt geleverd met ingebouwde WhatsApp-ondersteuning en kan worden uitgebreid om te werken met Telegram, e-mail en andere kanalen via het skillssysteem. Telegram toevoegen is zo eenvoudig als het uitvoeren van de /add-telegram skill, die je door de volledige configuratie begeleidt. De architectuur is zo ontworpen dat berichtenkanalen modulair zijn, zodat je een of meerdere kanalen naast elkaar kunt draaien, elk met hun eigen configuratie.

Welke container-runtimes worden ondersteund?

NanoClaw ondersteunt zowel Apple Container als Docker. Op macOS biedt Apple Container snelle, lichtgewicht sandboxing geoptimaliseerd voor Apple silicon, terwijl Docker als alternatief beschikbaar is. Op Linux wordt Docker automatisch gebruikt. Tijdens het initiële /setup-proces kies je welke runtime je wilt gebruiken op basis van je platform en voorkeuren.

Kan ik NanoClaw op Linux draaien?

Ja. NanoClaw draait op zowel macOS als Linux. Op Linux wordt Docker gebruikt als container-runtime en wordt automatisch geconfigureerd tijdens de setup. De systeemvereisten zijn Node.js 20 of hoger, Claude Code en een container-runtime (Docker op Linux). De /setup-skill regelt alle afhankelijkheidscontroles en configuratie voor je platform.

Hoe configureer ik NanoClaw?

NanoClaw gebruikt een AI-natief configuratieproces. Na het klonen van de repository en het starten van Claude Code, voer je de /setup-skill uit, die je begeleidt bij het installeren van afhankelijkheden, het authenticeren van je berichtenkanalen, het configureren van je container-runtime en het starten van de achtergrondservices. Er zijn geen handmatige configuratiebestanden om te bewerken. Claude Code regelt de volledige configuratie interactief. Voor latere wijzigingen kun je beschrijven wat je wilt en Claude Code zal de aanpassingen direct in de codebase doorvoeren.

Hoe verhoudt NanoClaw zich tot andere AI-agentframeworks?

De meeste AI-agentframeworks zijn ontworpen voor teams die producten bouwen. Ze zijn groot, complex en vereisen een aanzienlijke investering om te begrijpen. NanoClaw is ontworpen voor individuen die een persoonlijke AI-assistent willen die ze volledig bezitten en beheren. Het draait als een enkel Node.js-proces, gebruikt echte containerisolatie in plaats van sandboxing op applicatieniveau, en is klein genoeg om volledig te begrijpen. Het draait op Claude Agent SDK, waardoor je directe toegang hebt tot de mogelijkheden van Claude zonder abstractielagen.

Is NanoClaw open source?

Ja. Nano Claw is volledig open source onder de MIT-licentie. De volledige codebase is beschikbaar op GitHub en bijdragen zijn welkom. Het project moedigt forking en aanpassing aan. De filosofie is dat je persoonlijke AI-agent werkende software moet zijn die is afgestemd op jouw exacte behoeften, niet een generiek framework dat je configureert.