NanoClaw

Dein persönlicher KI-Agent. Sicher. Leichtgewichtig. Deiner.

NanoClaw läuft sicher in Containern, entwickelt um verstanden und an deine Bedürfnisse angepasst zu werden.

Sterne auf GitHub

Warum NanoClaw?

NanoClaw bietet die gleiche Kernfunktionalität in einer Codebasis, die du tatsächlich verstehen kannst.

		OpenClaw
Quelldateien	15	3.680
Codezeilen	~3.900	434.453
Abhängigkeiten	<10	70
Konfigurationsdateien	0	53
Zeit zum Verstehen	8 Minuten	1–2 Wochen
Sicherheitsmodell	Container-Isolation auf Betriebssystemebene	Prüfungen auf Anwendungsebene
Architektur	Einzelner Prozess + isolierte Container	Einzelner Prozess, geteilter Speicher

Was es bietet

Alles, was NanoClaw von Haus aus mitbringt, und nichts, was du nicht brauchst.

💬

Messaging-Apps

WhatsApp, Telegram und mehr. Schreibe deinem NanoClaw-Agenten von deinem Handy über die Apps, die du bereits nutzt.

🔒

Container-Isolation

Agenten laufen in Apple Container (macOS) oder Docker. Sie können nur sehen, was du explizit einbindest.

🐝

Agenten-Schwärme NEU

NanoClaw kann Teams spezialisierter Agenten erstellen, die bei komplexen Aufgaben zusammenarbeiten. Die erste persönliche KI, die das unterstützt.

🧠

Gruppen-Speicher

Jede Gruppe hat ihren eigenen CLAUDE.md-Speicher, ein isoliertes Dateisystem und läuft in ihrer eigenen Container-Sandbox.

⏰

Geplante Aufgaben

Wiederkehrende Aufträge, die Claude ausführen und dir die Antwort senden. Morgenbriefings, Wochenberichte und mehr.

🧩

Skill-System

Erweitere die Funktionalität ohne unnötigen Ballast. Füge Gmail, Telegram oder eigene Fähigkeiten über Skills hinzu.

✨

KI-native Einrichtung

Keine Installationsassistenten. Claude Code führt durch alles: Abhängigkeiten, Authentifizierung, Container, Dienste.

🌐

Webzugriff

NanoClaw kann im Web suchen, Inhalte abrufen und Seiten durchsuchen, um zu jedem Thema zu recherchieren.

Architektur

NanoClaw ist ein einzelner Node.js-Prozess. Agenten in isolierten Containern. 15 Quelldateien.

Eingehende Nachricht

WhatsApp / Telegram

SQLite

speichern und deduplizieren

Gruppen-Warteschlange

FIFO pro Gruppe

Container

Claude Agent SDK

Antwort

per Streaming übertragen

Einzelner Prozess

Ein einziger Node.js-Prozess fragt Nachrichten ab, verwaltet Warteschlangen, startet Container und handhabt IPC. Keine Microservices, keine Message-Broker.

Isolation pro Gruppe

Jede Gruppe erhält ihren eigenen Container, ihr eigenes Dateisystem, ihren eigenen IPC-Namensraum und ihre eigene Claude-Sitzung. Gruppen können nicht auf die Daten anderer Gruppen zugreifen.

Nebenläufigkeitskontrolle

GroupQueue begrenzt gleichzeitige Container (Standard: 3). FIFO-Reihenfolge pro Gruppe mit Wiederholungsversuchen bei Fehlern unter Verwendung von exponentiellem Backoff.

IPC über das Dateisystem

Container kommunizieren mit dem Host über JSON-Dateien in gruppenspezifischen Verzeichnissen. Der Host fragt ab, validiert die Autorisierung, führt aus und räumt auf.

Wichtige Dateien

index.ts — Orchestrator — Abfrageschleife, Nachrichtenverarbeitung, Agentenaufruf

container-runner.ts — Startet Container mit isolierten Mounts, überträgt die Ausgabe per Streaming

group-queue.ts — FIFO-Warteschlange pro Gruppe mit Nebenläufigkeitslimits und Backoff bei Wiederholungen

ipc.ts — Verarbeitet Container-IPC-Anfragen mit Autorisierungsprüfungen

db.ts — SQLite — Nachrichten, Sitzungen, Gruppen, Aufgaben, Router-Status

task-scheduler.ts — Ausführung geplanter Aufgaben mit Cron, Intervallen und Einmalausführung

Philosophie

Die Prinzipien, die jede Entscheidung bei NanoClaw leiten.

🔍

Klein genug zum Verstehen

NanoClaw ist ein einziger Prozess und eine Handvoll Quelldateien. Klein genug, um den gesamten Code lesen und verstehen zu können.

🛡️

Sicher durch Isolation

Agenten laufen in Linux-Containern. Sie können nur sehen, was explizit eingebunden wird. Bash ist sicher, weil es innerhalb des Containers läuft.

👤

Für einen einzelnen Nutzer gebaut

NanoClaw ist kein monolithisches Framework. Es ist funktionierende Software, die sich deinen genauen Bedürfnissen anpasst. Forke es, lass Claude Code es an dich anpassen.

🤖

KI-nativ

Kein Installationsassistent; Claude Code leitet die Einrichtung. Kein Dashboard; frag Claude. Keine Debugging-Tools; beschreib das Problem.

🧩

Skills statt Features

Mitwirkende fügen Claude Code Skills wie /add-telegram hinzu, die deine Installation transformieren. Am Ende hast du sauberen Code, der genau das tut, was du brauchst.

⚡

Beste Laufzeitumgebung, bestes Modell

Läuft auf Claude Agent SDK, was bedeutet, dass du Claude Code direkt ausführst. Die Laufzeitumgebung ist entscheidend. Eine gute gibt intelligenten Modellen Superkräfte.

Starte mit NanoClaw in 3 Zeilen

Klone NanoClaw, wechsle ins Verzeichnis und lass Claude den Rest erledigen.

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

Dann ausführen /setup Claude Code erledigt alles: Abhängigkeiten, Authentifizierung, Container-Einrichtung, Dienstkonfiguration.

Voraussetzungen

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

In den Medien

FAQ

Wie unterscheidet sich NanoClaw von OpenClaw?

NanoClaw (auch bekannt als Nano Claw) verfolgt einen grundlegend anderen Ansatz. Während OpenClaw ein umfangreiches Framework mit Tausenden von Quelldateien und Dutzenden von Abhängigkeiten ist, ist NanoClaw ein leichtgewichtiger persönlicher KI-Agent, der auf etwa 15 Quelldateien aufgebaut ist, die du in einer einzigen Sitzung lesen und verstehen kannst. NanoClaw nutzt Container-Isolation auf Betriebssystemebene (Docker oder Apple Container), um jede Agenten-Sitzung abzuschirmen, anstatt sich auf Berechtigungsprüfungen auf Anwendungsebene zu verlassen. Wenn du eine sichere, minimale Alternative zu OpenClaw suchst, die du vollständig auditieren und anpassen kannst, ist NanoClaw genau dafür entwickelt.

Ist NanoClaw sicher?

Sicherheit ist ein grundlegendes Designprinzip. Jede Agenten-Sitzung läuft in einem isolierten Linux-Container mit eigenem Dateisystem, IPC-Namensraum und Prozessraum. Agenten können nur auf explizit eingebundene Verzeichnisse zugreifen, und es gibt keinen impliziten Zugang zu deinem System. Da die gesamte Codebasis etwa 3.900 Zeilen in 15 Dateien umfasst, kannst du realistisch alles auditieren, was die Software tut. Diese Kombination aus Container-Isolation und einer kleinen, auditierbaren Codebasis macht NanoClaw zu einer der transparentesten und sichersten Möglichkeiten, KI-Agenten auszuführen.

Welche Messaging-Apps unterstützt NanoClaw?

NanoClaw wird mit integrierter WhatsApp-Unterstützung geliefert und kann über das Skill-System für Telegram, E-Mail und andere Kanäle erweitert werden. Telegram hinzuzufügen ist so einfach wie das Ausführen des /add-telegram Skills, der dich durch die gesamte Einrichtung führt. Die Architektur ist so gestaltet, dass Messaging-Kanäle modular sind, sodass du einen oder mehrere Kanäle parallel betreiben kannst, jeweils mit eigener Konfiguration.

Welche Container-Laufzeitumgebungen werden unterstützt?

NanoClaw unterstützt sowohl Apple Container als auch Docker. Auf macOS bietet Apple Container schnelles, leichtgewichtiges Sandboxing, optimiert für Apple silicon, während Docker als Alternative verfügbar ist. Auf Linux wird Docker automatisch verwendet. Während des initialen /setup-Prozesses wählst du die Laufzeitumgebung basierend auf deiner Plattform und deinen Präferenzen.

Kann ich NanoClaw auf Linux ausführen?

Ja. NanoClaw läuft sowohl auf macOS als auch auf Linux. Auf Linux wird Docker als Container-Laufzeitumgebung verwendet und während der Einrichtung automatisch konfiguriert. Die Systemvoraussetzungen sind Node.js 20 oder neuer, Claude Code und eine Container-Laufzeitumgebung (Docker auf Linux). Der /setup Skill übernimmt alle Abhängigkeitsprüfungen und die Konfiguration für deine Plattform.

Wie richte ich NanoClaw ein und konfiguriere es?

NanoClaw verwendet einen KI-nativen Einrichtungsprozess. Nach dem Klonen des Repositorys und dem Starten von Claude Code führst du den /setup Skill aus, der dich durch die Installation der Abhängigkeiten, die Authentifizierung deiner Messaging-Kanäle, die Konfiguration deiner Container-Laufzeitumgebung und das Starten der Hintergrunddienste führt. Es gibt keine manuell zu bearbeitenden Konfigurationsdateien. Claude Code übernimmt die gesamte Einrichtung interaktiv. Für spätere Änderungen beschreibst du, was du möchtest, und Claude Code nimmt die Änderungen direkt im Code vor.

Wie vergleicht sich NanoClaw mit anderen KI-Agent-Frameworks?

Die meisten KI-Agent-Frameworks sind für Teams konzipiert, die Produkte entwickeln. Sie sind groß, komplex und erfordern einen erheblichen Aufwand, um sie zu verstehen. NanoClaw ist für Einzelpersonen konzipiert, die einen persönlichen KI-Assistenten wollen, den sie vollständig besitzen und kontrollieren. Es läuft als einzelner Node.js-Prozess, nutzt echte Container-Isolation anstelle von Sandboxing auf Anwendungsebene und ist klein genug, um vollständig verstanden zu werden. Es läuft auf Claude Agent SDK und gibt dir direkten Zugang zu den Fähigkeiten von Claude ohne Abstraktionsschichten.

Ist NanoClaw Open Source?

Ja. Nano Claw ist vollständig Open Source unter der MIT-Lizenz. Die gesamte Codebasis ist auf GitHub verfügbar und Beiträge sind willkommen. Das Projekt ermutigt zum Forken und Anpassen. Die Philosophie ist, dass dein persönlicher KI-Agent funktionierende Software sein sollte, die auf deine genauen Bedürfnisse zugeschnitten ist, kein generisches Framework, das du konfigurierst.