So installieren Sie NanoClaw auf einem Mac mini

Was NanoClaw ist

NanoClaw ist ein Open-Source-KI-Assistent, den Sie auf Ihrem eigenen Computer betreiben. Er ist in TypeScript geschrieben, unter der MIT-Lizenz. Das README nennt ihn eine schlanke Alternative zu OpenClaw (github.com/nanocoai/nanoclaw, gelesen am 2. Oktober 2026). Das neueste Release war 2.4.0 vom 23. September 2026.

Der große Unterschied ist die Isolation. Jeder Agent läuft in einem eigenen Linux-Container. Er sieht nur die Ordner, die Sie in ihn einbinden. Der Agent baut auf dem Claude Agent SDK von Anthropic auf. Sie erreichen ihn über Chat-Apps wie WhatsApp, Telegram, Discord, Slack, Teams oder iMessage. Jeder Channel kommt mit einem eigenen Setup-Skill dazu.

Voraussetzungen

Diese stammen aus der Installationsdoku von NanoClaw (docs.nanoclaw.dev).

• macOS oder Linux mit mindestens 4 GB Arbeitsspeicher. Unter 3.700 MB warnt der Installer.
• Git, um den Code herunterzuladen. Das installiert der Installer nicht für Sie.
• Docker Desktop unter macOS. Agents laufen in Docker-Containern. Fehlt Docker Desktop, installiert der Installer es mit Homebrew.
• Node 22 oder neuer und pnpm 10 oder neuer. Fehlen sie, installiert der Installer beide.
• Claude Code auf dem Mac. NanoClaw nutzt es, um fehlgeschlagene Setup-Schritte zu reparieren und Channels hinzuzufügen.
• Zugangsdaten für ein Modell. Das Setup bietet Claude oder Codex an. Diese Anleitung nutzt einen API-Key von Anthropic, den Anthropic nach Nutzung abrechnet.

Installation

Prüfen Sie zuerst, ob Git vorhanden ist. Eine Zeile, die mit git version beginnt, heißt ja.

git --version

Dann führen Sie diese vier Befehle aus dem offiziellen Quick Start aus, Zeile für Zeile.

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

Das Skript prüft die Maschine und installiert, was fehlt. Dann stellt ein Setup-Assistent ein paar Fragen. Die Doku empfiehlt Standard setup, dann Fresh agent. Für alles zusammen plant sie 30 bis 60 Minuten ein.

• Sandbox-Image. Fetch the hardened image braucht ein kostenloses Konto bei NanoClaw. Build it here braucht kein Konto und dauert mehrere Minuten.
• KI-Dienst. Wählen Sie Claude, dann Paste an Anthropic API key. Das Setup speichert den Key in einem lokalen Tresor namens OneCLI. Er gelangt nie in den Container des Agents.
• Dienst. Das Setup startet NanoClaw im Hintergrund und schickt eine Testnachricht, um zu prüfen, ob der Agent antwortet.

Das Setup bietet auch Anmeldungen per Abo an. Wenn Sie eine davon nutzen wollen, prüfen Sie vorher die Bedingungen Ihres Anbieters zu Tools von Drittanbietern.

Nach dem Setup schicken Sie eine Nachricht aus dem Ordner nanoclaw. Der Text in Anführungszeichen ist Ihre Nachricht. Um den vollständigen Gesundheitscheck erneut auszuführen, nutzen Sie den Schritt verify.

cd ~/nanoclaw
pnpm run chat "Help me plan one of those weekend ideas."
pnpm run setup -- --step verify

Wir haben diese Installation noch nicht auf unserer eigenen Testmaschine ausgeführt. Die Befehle oben stammen aus der Doku von NanoClaw, Stand 2. Oktober 2026. Prüfen Sie sie erneut, bevor Sie anfangen.

Rund um die Uhr am Laufen halten

Das Setup installiert einen LaunchAgent im Ordner LaunchAgents Ihrer Home-Library. Sein Name sieht aus wie com.nanoclaw-v2 plus ein kurzer Code für Ihre Kopie. RunAtLoad und KeepAlive sind gesetzt. Er startet also bei der Anmeldung und startet nach einem Absturz neu. Das sind die dokumentierten Befehle.

# Find your label
launchctl list | grep nanoclaw

# Restart
launchctl kickstart -k gui/$(id -u)/com.nanoclaw-v2-<slug>

# Stop / start
launchctl unload ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist
launchctl load   ~/Library/LaunchAgents/com.nanoclaw-v2-<slug>.plist

# Logs (stdout and stderr go to files, not the system log)
tail -f logs/nanoclaw.log logs/nanoclaw.error.log

Docker muss ebenfalls laufen. Sonst kann kein Agent starten. Laut Doku zur Fehlerbehebung starten Sie Docker Desktop, prüfen, ob docker info funktioniert, und starten NanoClaw dann neu. Aktivieren Sie in den Einstellungen von Docker Desktop die Option, es bei der Anmeldung zu starten.

Ein LaunchAgent läuft nur, solange ein Benutzer angemeldet ist. Nach einem Neustart startet nichts, bis sich jemand anmeldet. Auf einem unbeaufsichtigten Mac aktivieren Sie die automatische Anmeldung für das Konto, unter dem NanoClaw läuft. Dann verhindern Sie den Ruhezustand. Der Ruhezustand pausiert Docker und trennt jede Chat-Verbindung.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Die Gründe stehen in was passiert, wenn ein Mac schläft. Die vollständige Checkliste, inklusive Stromausfällen, steht im Leitfaden für den dauerhaft eingeschalteten Mac.

Hinweise zur Sicherheit

• Agents sehen nur die Ordner, die Sie erlauben. Die Allowlist-Datei ist mount-allowlist.json in ~/.config/nanoclaw, außerhalb des Checkouts. Bei einer frischen Installation ist sie leer.
• Agents halten nie Ihren rohen API-Key. Ausgehende Anfragen laufen über den Tresor, der den Key erst bei der Anfrage hinzufügt.
• Das Setup sendet anonyme Diagnosedaten. Mit NANOCLAW_NO_DIAGNOSTICS=1 schalten Sie sie ab.
• Die Doku hat eine Seite zur Härtung für strengere Setups. Sie behandelt Grenzen für den Netzwerkzugriff, wer dem Agent schreiben darf und welche Befehle er ausführen darf.

Container helfen, aber eine dedizierte Maschine hilft mehr. Lassen Sie NanoClaw auf einem Mac laufen, auf dem sonst nichts von Ihnen liegt. Wenn der Agent etwas Seltsames tut, endet der Schaden an dieser Maschine. Um es später zu entfernen, nennt die Doku ein Flag zur Deinstallation. Mit --dry-run sehen Sie vorab, was entfernt würde.

bash nanoclaw.sh --uninstall

Auf einem Mac von MacRun betreiben

Unser Agent-Tarif ist ein dedizierter Mac mini, der nie schläft. Er steht an unserem eigenen, privaten Standort in New Jersey. Seine Anmeldesitzung kommt nach einem Neustart von selbst zurück, also starten LaunchAgents wieder. Claude Code und Codex sind vorinstalliert. Damit ist der Bedarf von NanoClaw an Claude Code gedeckt. NanoClaw und Docker Desktop sind nicht vorinstalliert. Sie installieren sie selbst, denn Sie haben volle Admin-Rechte.

Der Basis-M6 hat 16 GB Arbeitsspeicher, weit über dem Minimum von 4 GB. Der Agent-Tarif kostet $169 pro Monat. MacRun verkauft keine API-Keys. Nutzen Sie einen API-Key Ihres Modellanbieters, der die Nutzung nach seinen eigenen Bedingungen abrechnet.

Wann Sie MacRun nicht brauchen

Wenn Sie schon einen Mac haben, der an und angemeldet bleibt, nutzen Sie ihn. Die Schritte oben sind dieselben. NanoClaw läuft auch unter Linux mit Docker Engine. Wenn Sie nichts von macOS brauchen, kostet ein kleiner Linux-Server weniger als jeder Mac.

MacRun ist außerdem für Entwicklerarbeit unter unserer Richtlinie zur zulässigen Nutzung. Ein NanoClaw, das Code prüft, die CI beobachtet oder Release Notes schreibt, passt. Eines, das Ihren Familienchat betreibt, passt nicht. Bereit, es auf einer Maschine zu testen, die an bleibt? Sehen Sie sich die Seite zum Agent-Mac an.