NanoClaw KI-Agent FAQ

NanoClaw ist ein schlanker, quelloffener persönlicher KI-Assistent, der auf dem Anthropic Claude Agent SDK basiert. Agenten laufen in isolierten Linux-Containern (Apple Container auf macOS, Docker auf macOS/Linux). WhatsApp integriert, weitere Kanäle über Skills. Mit dauerhaftem SQLite-Speicher, geplanten Aufgaben, Webzugriff, Browser-Automatisierung und Agenten-Schwärmen.

Führen Sie 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' aus und verwenden Sie /setup in der Claude-Sitzung. Claude Code übernimmt Abhängigkeiten, Authentifizierung, Container-Einrichtung und Dienstkonfiguration. Erfordert Node.js 20+ und Claude Code.

NanoClaw ist klein genug, um es zu verstehen — ein Prozess, wenige Quelldateien, keine Microservices. Anders als aufgeblähte Frameworks können Sie die gesamte Codebasis lesen. Agenten laufen in echten Linux-Containern mit Dateisystem-Isolation, nicht hinter Berechtigungsprüfungen auf Anwendungsebene.

NanoClaw läuft ausschließlich auf dem Anthropic Claude Agent SDK. Claude Code ist global in jedem Container installiert und übernimmt alle KI-Interaktionen. Das SDK verwaltet die Modellauswahl intern — NanoClaw ist als Einzelanbieter-System konzipiert.

WhatsApp ist der integrierte Kanal (über die Baileys-Bibliothek, QR-Code-Kopplung). Telegram, Discord und Slack können über Claude Code Skills hinzugefügt werden — führen Sie /add-telegram, /add-discord oder /add-slack aus. Skills ändern den Quellcode Ihres Forks, um saubere, dedizierte Kanalunterstützung hinzuzufügen.

Sicherheit ist ein zentrales Designprinzip. Agenten laufen in Linux-Containern (Apple Container auf macOS, Docker auf macOS/Linux) mit Dateisystem-Isolation — nicht hinter Berechtigungsprüfungen auf Anwendungsebene. Geheimnisse werden über stdin-JSON übergeben und nie in process.env geladen. Mount-Erlaubnislisten mit Symlink-Ausbruchserkennung. Container laufen ohne Root-Rechte mit schreibgeschützten Projekt-Mounts.

NanoClaw verwendet SQLite (better-sqlite3) für dauerhafte Speicherung — Nachrichten, Gruppen, Sitzungen, geplante Aufgaben und Router-Zustand. Jede Gruppe hat außerdem ihre eigene CLAUDE.md-Datei für gruppenspezifischen Speicher, der in ihren Container eingebunden wird. Keine externe Datenbank erforderlich.

Ja. NanoClaw läuft auf macOS und Linux — überall, wo Node.js 20+ und Docker laufen. Der schlanke TypeScript-Kern funktioniert auf ressourcenarmen Geräten einschließlich Raspberry Pi. Erfordert eine Container-Laufzeitumgebung (Apple Container oder Docker) und einen Anthropic API-Schlüssel.

Agenten-Schwärme ermöglichen es NanoClaw, Teams spezialisierter Agenten zu starten, die bei komplexen Aufgaben zusammenarbeiten. NanoClaw ist der erste persönliche KI-Assistent mit Unterstützung für Agenten-Schwärme, basierend auf der agent-teams-Fähigkeit von Claude Code.

Das Projekt ist quelloffen unter MIT-Lizenz auf github.com/qwibitai/nanoclaw. Lesen Sie die README für Beitragsrichtlinien. Alle Beiträge sind willkommen.

Integrierte Werkzeuge werden von Claude Code bereitgestellt, das in Containern läuft: Shell-Befehle, Datei-Lesen/-Schreiben, Websuche, Web-Browsing (Chromium) und Agenten-Delegation (Schwärme). Der Host-Prozess bietet geplante Aufgaben (Cron), dauerhaften SQLite-Speicher und WhatsApp-Messaging. Erweitern Sie die Funktionalität durch Hinzufügen von Skills.

Ja. Jeder Agenten-Container hat Chromium installiert und agent-browser für Browser-Automatisierung. Claude Code kann im Web suchen und Seiten durchstöbern, um Echtzeitinformationen innerhalb des Sandbox-Containers abzurufen.

Das offizielle und einzig vertrauenswürdige Repository ist github.com/qwibitai/nanoclaw. Der Community-Discord ist discord.gg/VDdww8qS42.

macOS und Linux. Erfordert Node.js 20+ und eine Container-Laufzeitumgebung — Apple Container auf macOS oder Docker auf macOS/Linux. Windows wird nicht offiziell unterstützt, funktioniert aber möglicherweise über WSL2 mit Docker.

NanoClaw verwendet ausschließlich Anthropic Claude über das Claude Agent SDK. Setzen Sie ANTHROPIC_API_KEY in Ihrer .env-Datei oder authentifizieren Sie sich über Claude Code OAuth. Es gibt keine Multi-Anbieter-Unterstützung — das SDK verwaltet die Modellauswahl intern.

Die README im GitHub-Repository (github.com/qwibitai/nanoclaw) ist die primäre Dokumentationsquelle. Das docs/-Verzeichnis enthält Architekturspezifikationen, Sicherheitsmodell und Debug-Checkliste. Die Codebasis ist klein genug, um Claude Code zu bitten, Sie hindurchzuführen.

Offizielle Kanäle: Discord (discord.gg/VDdww8qS42) und GitHub (github.com/qwibitai/nanoclaw). Lesen Sie die README für alle Community-Links.