Veelgestelde vragen
Veelgestelde vragen over NanoClaw en hoe het werkt.
NanoClaw is een lichtgewicht, opensource persoonlijke AI-assistent gebouwd op de Anthropic Claude Agent SDK. Agents draaien in geïsoleerde Linux-containers (Apple Container op macOS, Docker op macOS/Linux). WhatsApp ingebouwd, andere kanalen via skills. Met persistent SQLite-geheugen, geplande taken, webtoegang, browserautomatisering en agent-zwermen.
Voer 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' uit en gebruik /setup in de Claude-sessie. Claude Code regelt afhankelijkheden, authenticatie, containerconfiguratie en serviceconfiguratie. Vereist Node.js 20+ en Claude Code.
NanoClaw is klein genoeg om te begrijpen — één proces, een paar bronbestanden, geen microservices. In tegenstelling tot opgeblazen frameworks kun je de hele codebase lezen. Agents draaien in echte Linux-containers met bestandssysteemisolatie, niet achter rechtencontroles op applicatieniveau.
NanoClaw draait uitsluitend op de Anthropic Claude Agent SDK. Claude Code is globaal geïnstalleerd in elke container en verzorgt alle AI-interacties. De SDK regelt modelselectie intern — NanoClaw is bewust ontworpen voor één aanbieder.
WhatsApp is het ingebouwde kanaal (via Baileys-bibliotheek, QR-codekoppeling). Telegram, Discord en Slack kunnen worden toegevoegd via Claude Code-skills — voer /add-telegram, /add-discord of /add-slack uit. Skills passen de broncode van je fork aan om schone, toegewijde kanaalondersteuning toe te voegen.
Beveiliging is een kernprincipe van het ontwerp. Agents draaien in Linux-containers (Apple Container op macOS, Docker op macOS/Linux) met bestandssysteemisolatie — niet achter rechtencontroles op applicatieniveau. Geheimen worden via stdin-JSON doorgegeven en nooit in process.env geladen. Mount-allowlists met symlink-escapdetectie. Containers draaien als niet-root met alleen-lezen projectmounts.
NanoClaw gebruikt SQLite (better-sqlite3) voor persistente opslag — berichten, groepen, sessies, geplande taken en routerstatus. Elke groep heeft ook een eigen CLAUDE.md-bestand voor geheugen per groep, gemount in de container. Geen externe database nodig.
Ja. NanoClaw draait op macOS en Linux — overal waar Node.js 20+ en Docker draaien. De lichtgewicht TypeScript-kern werkt op apparaten met weinig resources, waaronder Raspberry Pi. Vereist een containerruntime (Apple Container of Docker) en een Anthropic API-sleutel.
Agent-zwermen laten NanoClaw teams van gespecialiseerde agents opstarten die samenwerken aan complexe taken. NanoClaw is de eerste persoonlijke AI-assistent met ondersteuning voor agent-zwermen, gebouwd op de agent-teams-functionaliteit van Claude Code.
Het project is opensource onder MIT-licentie op github.com/qwibitai/nanoclaw. Bekijk de README voor richtlijnen voor bijdragen. Alle bijdragen zijn welkom.
Ingebouwde tools worden geleverd door Claude Code dat in containers draait: shellcommando's, bestanden lezen/schrijven, webzoekopdrachten, webbrowsen (Chromium) en agentdelegatie (zwermen). Het hostproces biedt geplande taken (cron), persistent SQLite-geheugen en WhatsApp-berichten. Breid functionaliteit uit door skills toe te voegen.
Ja. Elke agentcontainer heeft Chromium geïnstalleerd en agent-browser voor browserautomatisering. Claude Code kan het web doorzoeken en pagina's bekijken voor realtime informatie binnen de sandbox-container.
De officiële en enige vertrouwde repository is github.com/qwibitai/nanoclaw. De community Discord is discord.gg/VDdww8qS42.
macOS en Linux. Vereist Node.js 20+ en een containerruntime — Apple Container op macOS of Docker op macOS/Linux. Windows wordt niet officieel ondersteund maar kan werken via WSL2 met Docker.
NanoClaw gebruikt uitsluitend Anthropic Claude via de Claude Agent SDK. Stel ANTHROPIC_API_KEY in via je .env-bestand, of authenticeer via Claude Code OAuth. Er is geen multi-providerondersteuning — de SDK regelt modelselectie intern.
De README in de GitHub-repository (github.com/qwibitai/nanoclaw) is de primaire documentatiebron. De docs/-map bevat architectuurspecificaties, beveiligingsmodel en debugchecklist. De codebase is klein genoeg om Claude Code te vragen je erdoorheen te leiden.
Officiële kanalen: Discord (discord.gg/VDdww8qS42) en GitHub (github.com/qwibitai/nanoclaw). Bekijk de README voor alle gemeenschapslinks.