NanoClaw Entwickler-Guide
NanoClaw ist eine kleine, container-isolierte KI-Assistenz-Laufzeit, die verständlich, anpassbar und durch Trennung auf Betriebssystemebene statt nur durch Anwendungsberechtigungen sicher sein soll. Dieser Guide erklärt, wie NanoClaw funktioniert, wie das Setup gestaltet ist, wie seine Host- und Container-Schichten zusammenarbeiten und wo du es erweitern kannst.
Dieser Guide basiert auf den offiziellen NanoClaw-Docs und dem offiziellen Repository nanocoai/nanoclaw, geprüft am 26. Juni 2026.
In diesem Abschnitt
- Setup und erster Start
- Architektur und Laufzeit
- Konfiguration und Sicherheit
- Erweitern und Beitragen
- Einfacher Benutzer-Guide
1. Was NanoClaw ist
Die kürzeste zutreffende Beschreibung lautet:
NanoClaw ist eine kleine Host-Laufzeit, die KI-Agenten in eigenen Containern ausführt und die Codebasis bewusst leicht verständlich und anpassbar hält.
Die README ist ungewöhnlich explizit über ihre Design-Haltung:
- klein genug, um verständlich zu sein,
- sicher durch Isolation,
- für Einzelpersonen gebaut,
- Anpassung durch Code,
- und Skills statt aufgeblähter Built-ins.
2. Das mentale Modell
Stell dir NanoClaw als fünf zusammenwirkende Schichten vor:
| Schicht | Was sie tut |
|---|---|
| Host-Prozess | Routet Nachrichten, verwaltet Sitzungen, übernimmt die Zustellung |
| Container pro Agent | Isolierte Ausführungsumgebungen für Assistenten |
| Sitzungsspeicher | Nutzt SQLite-Dateien für ein- und ausgehenden Nachrichtenfluss |
| Kanal- und Anbieter-Registry | Fügt Messaging-Kanäle und Modellanbieter bei Bedarf hinzu |
| nutzereigener Fork und Skills | Fördert maßgeschneiderte Anpassung statt Konfigurations-Wildwuchs |
3. Warum Entwickler es wählen würden
- Es ist um echte Container-Isolation herum gebaut.
- Die Codebasis ist bewusst klein und auditierbar.
- Es behandelt Anpassung als Code, nicht als endlose Einstellungs-UI.
- Es unterstützt Multi-Channel-Messaging, ohne alle Features in den Trunk zu zwingen.
4. Was es ungewöhnlich macht
NanoClaws stärkste Überzeugung ist, dass das sicherste Erweiterbarkeitsmodell lautet:
halte den Trunk klein, installiere Kanäle und Anbieter über Skills und lass die Nutzenden ihren Fork besitzen
Das ist eine ganz andere Philosophie als „packe jedes Feature in einen Monolithen“.
5. Empfohlene Lesereihenfolge
- diesen Überblick,
- Quick Start,
- Architektur und Isolationsmodell,
- Sicherheitsdokumentation,
- Beitragsanleitung rund um Skills und Branches.