NanoClaw-Tutorial: Einen schlanken Local-First-Agent aufsetzen

Autonome KI-Agenten verändern, wie wir mit Software arbeiten. Statt zwischen Apps und Tools zu wechseln, gibst du einen einfachen Textbefehl ein und der Agent übernimmt die Aufgabe für dich. Das kann Erinnerungen setzen, bei E-Mails helfen, Projektmanagement unterstützen oder beim Programmieren und Schreiben assistieren.

Tools wie OpenClaw haben diese Idee deutlich praxistauglicher gemacht. Sie zeigen, was möglich ist, wenn ein KI-Agent auf deinem Laptop oder Smartphone jederzeit bereitsteht. Gleichzeitig wirken größere Agentensysteme oft schwergewichtig, komplex und aufwendig in der Verwaltung. Sie können Sicherheitsbedenken mitbringen, mehr Einrichtung verlangen und für einen persönlichen lokalen Workflow über das Ziel hinausschießen.

Genau hier setzt NanoClaw an. NanoClaw ist eine leichtere Local-First-Alternative, die sich einfacher auf deinem eigenen Rechner ausführen und ausprobieren lässt. Das System ist zudem mit Blick auf Sicherheit entwickelt und nutzt Docker-basierte Isolation, um deine Umgebung abzuschotten und Daten zu schützen.

In diesem Tutorial richtest du NanoClaw unter Windows mit WSL ein und bereitest die Umgebung Schritt für Schritt vor. Du installierst die nötigen Systemtools, setzt Node.js auf, klonst das NanoClaw-Repository, verbindest die Authentifizierung und bringst das Projekt lokal zum Laufen.

Für einen Vergleich der beiden Agenten-Tools lies am besten unseren Leitfaden NanoClaw vs OpenClaw.

1. WSL und deine Linux-Umgebung einrichten

Bevor du startest, brauchst du einen aktuellen Windows-10/11-PC, der WSL 2 und Hardware-Virtualisierung unterstützt, genügend RAM (mindestens 4 GB, idealerweise 8 GB oder mehr) und freien Speicher (ca. 20–30 GB), um Docker Desktop und eine Ubuntu-WSL-Umgebung auszuführen.

Installiere zunächst WSL unter Windows. Öffne PowerShell als Administrator und führe aus:

wsl --install

Starte nach der Installation bei Bedarf neu und prüfe dann dein Setup:

wsl --status

Deine Distribution sollte auf WSL 2 laufen. Das ist wichtig, weil Claude Code WSL unter Windows unterstützt und Anthropic darauf hinweist, dass Sandboxing mit WSL 2 funktioniert, während WSL 1 nicht unterstützt wird.

Sobald WSL bereit ist, starte Ubuntu:

wsl

Aktualisiere in Ubuntu das System und installiere die grundlegenden Development-Tools:

sudo apt update && sudo apt upgrade -y\nsudo apt install -y build-essential curl git wget

Damit hast du eine saubere Linux-Umgebung mit den Kernwerkzeugen für den weiteren Aufbau.

2. Node.js, Docker und Claude Code installieren

Bevor du NanoClaw selbst installierst, musst du die benötigten Tools vorbereiten. 

In diesem Abschnitt installierst du Node.js, damit das Projekt seine JavaScript-Tools ausführen kann, stellst sicher, dass Docker in WSL verfügbar ist, damit NanoClaw isolierte Container nutzen kann, und installierst Claude Code, das du für das geführte NanoClaw-Setup verwendest.

Node.js mit NVM installieren

Am einfachsten installierst du Node.js in WSL mit NVM, dem Node Version Manager. Dadurch kannst du Node-Versionen flexibel verwalten, ohne den Systempaketmanager zu bemühen.

Führe in deinem Ubuntu-Terminal Folgendes aus:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash\n\\. \"$HOME/.nvm/nvm.sh\"\nnvm install 24\nnode -v\nnpm -v

Danach solltest du eine Ausgabe ähnlich dieser sehen:

v24.14.1\n11.11.0

Node.js wird benötigt, weil NanoClaw auf einem JavaScript-basierten Setup und Abhängigkeitsfluss aufsetzt. Die Installation über NVM ist hilfreich, da sie deine Umgebung langfristig leichter handhabbar macht. Wenn du jemals Versionen wechseln oder Node neu installieren musst, geht das, ohne den Rest deines Linux-Setups zu beeinflussen.

Sicherstellen, dass Docker in WSL funktioniert

NanoClaw läuft durch Docker-basierte Container-Isolation sicherer und kontrollierter. Das bedeutet, Docker muss unter Windows installiert und korrekt mit deiner WSL-Umgebung verbunden sein.

Lade zuerst Docker Desktop von der Docker-Website herunter und installiere es unter Windows. Öffne dann Docker Desktop, wechsle in die Einstellungen, aktiviere die Option Use the WSL 2-based engine und schalte unter Resources → WSL Integration die Integration für deine Ubuntu-Distribution ein.

Wechsle danach zurück in dein Ubuntu-Terminal und führe aus:

docker --version\ndocker ps

Die Ausgabe sollte in etwa so aussehen:

Docker version 29.1.3, build f52814d\nCONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

Das ist ein gutes Zeichen. Docker ist in WSL verfügbar und bereit für NanoClaw.

Claude Code in Ubuntu installieren

Mit vorbereitetem Node und Docker installierst du als Nächstes Claude Code in WSL. Darüber schließt du das geführte Setup von NanoClaw ab.

Führe aus:

curl -fsSL https://claude.ai/install.sh | bash

Damit installierst du Claude Code direkt in deiner Ubuntu-Umgebung.

3. NanoClaw aus dem Quellcode installieren

Jetzt, wo die Umgebung steht, lädst du NanoClaw herunter und öffnest es in Claude Code.

Klonen des Repositories und Wechsel in den Projektordner:

git clone https://github.com/qwibitai/nanoclaw.git\ncd nanoclaw

Wenn du NanoClaw später anpassen willst, kannst du das Repository zuerst forken und stattdessen deine eigene Kopie klonen. Für den ersten Durchlauf ist das Klonen des Haupt-Repositories völlig ausreichend.

Sobald du im Ordner nanoclaw bist, führe aus:

claude

Beim ersten Start führt dich Claude Code durch Anmeldung und Grundeinrichtung. Du kannst dich mit einem Claude.ai-Konto anmelden oder direkten Anthropic-API-Zugang mit einem API-Schlüssel nutzen.

Wenn du bereits ein Claude Pro- oder Max-Abo hast, ist die Anmeldung meist der einfachste Weg. Arbeitest du stattdessen mit API-Abrechnung, lässt sich Claude Code auch mit deinem Anthropic-API-Schlüssel konfigurieren.

Nach der Anmeldung öffnet sich Claude Code in deinem NanoClaw-Projekt und du kannst mit dem Setup fortfahren.

4. NanoClaw einrichten

Mit geöffnetem Claude Code im Ordner nanoclaw startest du jetzt die vollständige Einrichtung.

Führe aus:

/setup

Damit startest du den geführten Setup-Flow von NanoClaw.

Was während des Setups passiert

Nachdem du /setup ausgeführt hast, beginnt Claude Code, NanoClaw für dich vorzubereiten. Dieser Teil kann etwas dauern, also lass es die Schritte in Ruhe durchlaufen.

Zuerst werden die Projektabhängigkeiten installiert und geprüft, ob deine lokale Umgebung bereit ist. 

Danach folgt die Container-Phase, in der die nötigen Docker-Befehle ausgeführt werden, um den benutzerdefinierten NanoClaw-Container zu bauen und seinen Start zu testen.

Sobald der Container gebaut und verifiziert ist, installiert das Setup OneCLI. Das ist ein wichtiger Baustein im NanoClaw-Stack, weil er Secrets und den Containerzugriff sicherer verwaltet.

Nach Abschluss kannst du im Docker-Desktop-Dashboard prüfen, ob die Container laufen. Zu diesem Zeitpunkt solltest du dort die NanoClaw-Services sehen, darunter den App-Container und unterstützende Dienste wie PostgreSQL.

Claude-Token für OneCLI einrichten

Auch wenn Claude Code in WSL bereits angemeldet ist, braucht der NanoClaw-Container einen eigenen sicheren Zugriff auf Claude. Dafür musst du ein Token generieren und bei OneCLI registrieren.

Öffne ein neues Terminal und führe aus:

claude setup-token

Der Befehl erzeugt einen Link für den Browser. Melde dich an, genehmige die Anfrage und füge den zurückgegebenen Code wieder im Terminal ein. Danach stellt dir Claude Code ein Token bereit.

Kopiere dieses Token und führe dann folgenden Befehl im Terminal aus. Ersetze YOUR_TOKEN durch das eben generierte Token:

onecli secrets create --name Anthropic --type anthropic --value YOUR_TOKEN --host-pattern api.anthropic.com

Damit erhält der NanoClaw-Container sicheren Zugriff auf Claude, ohne deine Zugangsdaten direkt im Container offenzulegen. Anschließend ist das Setup bereit für den nächsten Schritt.

5. WhatsApp für NanoClaw einrichten

Nach Abschluss der Hauptinstallation wechselt Claude Code zur Channel-Einrichtung. Hier wählst du aus, wie du mit NanoClaw interagieren willst.

QR-Code für WhatsApp generieren

Wähle WhatsApp (du kannst auch andere unterstützte Kanäle wie Discord, Telegram oder Slack für später markieren, wir konzentrieren uns hier aber auf WhatsApp) und fahre fort.

Aus irgendeinem Grund funktionierte der QR-Code im Browser bei mir nicht. Ursache war vermutlich ein Netzwerkproblem zwischen WSL und dem Browser, wahrscheinlich beim Zugriff auf den lokalen Port. Daher nutzen wir stattdessen die Option, den QR-Code im Terminal zu generieren.

Claude Code versucht, einen QR-Code im Terminal anzuzeigen. In manchen Fällen wird dieser abgeschnitten oder nicht korrekt dargestellt.

Öffne zur Abhilfe ein neues Terminal und führe aus:

cd nanoclaw\nnpm run auth

Damit erzeugst du einen sauber dargestellten QR-Code im Terminal.

WhatsApp auf deinem Smartphone verbinden

Öffne jetzt WhatsApp auf deinem Smartphone und gehe so vor:

\n
• Wechsle zu Einstellungen
\n
• Tippe auf Verknüpfte Geräte
\n
• Tippe auf Gerät verknüpfen
\n
• Scanne den im Terminal angezeigten QR-Code
\n

Nach erfolgreichem Scan ist dein WhatsApp-Konto mit NanoClaw verbunden.

Nach dem Koppeln solltest du im Terminal eine Erfolgsmeldung sehen.

Channel-Einrichtung in Claude Code abschließen

Wechsle zurück in dein ursprüngliches Claude-Code-Terminal und setze die Einrichtung fort.

Du wirst nach einigen Konfigurationen gefragt. Fürs Erste kannst du die Empfehlungen übernehmen.

\n
• Lass das Trigger-Wort auf Standard
\n
• Lass den Assistentennamen auf Standard
\n
• Wähle den Modus Self-Chat
\n

Self-Chat bedeutet, NanoClaw antwortet nur dir in deinem eigenen WhatsApp-Chat. Praktisch zum Testen, weil niemand sonst mit deinem Agenten interagieren kann.

Einrichtung finalisieren und testen

Sobald alles konfiguriert ist, baut NanoClaw den Container mit deinen Einstellungen neu. Das kann kurz dauern.

Danach siehst du Anweisungen zur Nutzung von NanoClaw.

Zum Testen:

\n
• Öffne WhatsApp
\n
• Suche nach deiner eigenen Nummer (dein Self-Chat)
\n
• Sende eine Nachricht wie:
\n

@Andy hello

Wenn alles korrekt läuft, antwortet NanoClaw in deinem Chat.

6. NanoClaw mit WhatsApp testen

Jetzt, wo alles eingerichtet ist, kannst du NanoClaw direkt aus WhatsApp testen.

Öffne WhatsApp auf deinem Smartphone und gehe in deinen eigenen Chat. Dieser erscheint als deine Nummer mit \"(Du)\" in Klammern. Starte mit einer einfachen Nachricht wie:

@Andy how are you?

Innerhalb weniger Sekunden sollte NanoClaw im Chat antworten. Das bestätigt, dass deine Einrichtung funktioniert und der Agent mit WhatsApp verbunden ist.

Du kannst auch den Trigger testen. Sende eine Nachricht ohne das Trigger-Wort, zum Beispiel:

How are you?

Du wirst feststellen, dass NanoClaw nicht antwortet. Das ist beabsichtigt: Das Trigger-Wort stellt sicher, dass der Agent nur auf deine ausdrückliche Aufforderung aktiviert wird.

Wenn die Basisnachrichten funktionieren, probiere eine anspruchsvollere Aufgabe. Bitte zum Beispiel:

@Andy Tell me the latest gold and silver prices and should i buy it or not

NanoClaw führt die Aufgabe aus und liefert eine strukturierte Antwort. Das zeigt, dass dein Agent nicht nur Nachrichten beantwortet, sondern auch mehrstufige Aufgaben erledigen und nützliche Ergebnisse liefern kann, wenn er mit den richtigen Tools (z. B. Websuche) konfiguriert ist.

Damit ist dein NanoClaw-Setup voll funktionsfähig und bereit für weiterführende Anwendungsfälle.

Die Gold- und Silberpreise waren allerdings falsch – das deutet darauf hin, dass keine tatsächliche Websuche durchgeführt wurde und stattdessen auf veraltetes Modellwissen zurückgegriffen wurde.

Fazit

Die Einrichtung von NanoClaw hat deutlich länger gedauert als erwartet – besonders unter Windows mit WSL. Zwischen Docker, Container-Setup, mehreren begleitenden Diensten und den vielen Berechtigungen, die ich in Claude Code immer wieder bestätigen musste, wirkte der Prozess schwerfälliger, als man es bei einem schlanken lokalen Agenten erwarten würde. Mit der Zeit wurden die ständigen Prompts und Bestätigungen ermüdend, und insgesamt fühlte sich das Setup nicht gerade einsteigerfreundlich an.

Auch der Installationsfluss war nicht so reibungslos wie erhofft. Mehrfach bat mich Claude Code, neue Terminals zu öffnen, zusätzliche Authentifizierungsbefehle auszuführen, Tokens zu generieren und diese manuell bei OneCLI zu registrieren. Wenn du neu bei KI-Tools, Containern oder der Arbeit im Terminal bist, kann das schnell verwirren. Es ist machbar, verlangt aber mehr manuelle Schritte, als viele Nutzende vermutlich erwarten.

Deshalb hat mir persönlich Nanobot besser gefallen. Ich konnte innerhalb weniger Minuten meinen Agenten über WhatsApp anschreiben, und die Erfahrung war spürbar schneller und direkter. Bei NanoClaw wirkte das Verhältnis aus Aufwand und Ergebnis weniger überzeugend.

Auch die WhatsApp-Erfahrung selbst hat noch Luft nach oben. Die Antworten kamen zwar, aber die Interaktion wirkte holprig. Es gab keinen klaren Tipp- oder Antwortindikator, und die Antwortblasen sahen genauso aus wie meine eigenen Nachrichten – das machte die Unterhaltung weniger natürlich. Eine deutlichere visuelle Unterscheidung und etwas Feedback, dass der Agent gerade arbeitet, würden hier viel ausmachen, vor allem bei längeren Antwortzeiten.

Insgesamt halte ich die Idee hinter NanoClaw weiterhin für stark. Ein sicherer, lokaler, leichter Agent geht in die richtige Richtung. In der Praxis war die Einrichtung jedoch komplexer als gedacht, und das Enderlebnis fühlte sich im Vergleich zum Aufwand etwas enttäuschend an.