So installieren Sie nanobot auf einem Mac mini

Was nanobot ist

nanobot ist ein persönlicher Open-Source-KI-Agent der Gruppe HKUDS auf GitHub. Er ist in Python geschrieben, unter der MIT-Lizenz. Wie OpenClaw behält er ein Gedächtnis, führt Tools aus und antwortet Ihnen über Chat-Apps. Sein Kern ist klein und lesbar gehalten (github.com/HKUDS/nanobot, gelesen am 2. Oktober 2026). Das neueste Release auf PyPI war 0.3.5 vom 15. September 2026.

Sie können ihn in einer WebUI im Browser nutzen, im Terminal oder über Telegram, Discord, Slack, E-Mail und andere Channels. Er kann mit Dateien arbeiten, Shell-Befehle ausführen, im Web suchen, MCP-Server nutzen und geplante Jobs ausführen. Noch ein Hinweis zum Namen. Das ist nicht obot-platform/nanobot, ein Go-Framework zum Bauen von MCP-Agents.

Voraussetzungen

• Python 3.11 oder neuer. Prüfen Sie das mit python3 --version. Der Installer bricht ab, wenn er keins findet. Installieren Sie Python also bei Bedarf zuerst.
• macOS 13 oder neuer. Die vorgebauten Pakete für Macs mit Apple Silicon und Intel enthalten die WebUI und die Terminal-Oberfläche.
• Ein Modellanbieter. Anthropic, OpenAI, OpenRouter und lokale Server wie Ollama behandelt die Doku zu den Anbietern. Nutzen Sie einen API-Key des Anbieters, den Sie wählen.
• Git und Bun, aber nur, wenn Sie aus dem Quellcode installieren. Die normale Installation braucht sie nicht.

Installation

Führen Sie den offiziellen Installer mit einem Befehl aus dem README aus.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

Er installiert das Paket nanobot-ai von PyPI. Systemweite Installationen mit pip vermeidet er. Er nutzt eine aktive virtuelle Umgebung, uv, pipx oder eine eigene Umgebung im Ordner .nanobot in Ihrem Home-Verzeichnis. Dann gibt er den genauen Befehl aus, den er genutzt hat. Um den Plan zu sehen, ohne etwas zu ändern, ergänzen Sie das Flag für einen Probelauf.

curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh -s -- --dry-run

Wenn Sie schon uv nutzen, erledigt das dasselbe. Prüfen Sie dann die Version.

uv tool install nanobot-ai
nanobot --version

Erster Start und ein Modell

Das README empfiehlt für den ersten Start die WebUI. Sie öffnet sich auf 127.0.0.1, Port 8765, und lauscht nur auf diesem Mac.

nanobot webui

Öffnen Sie Settings, dann Models. Wählen Sie einen Anbieter, fügen Sie seinen API-Key ein und wählen Sie ein Modell. Dann starten Sie ein neues Thema und schicken Hello. Jede normale Antwort heißt, dass Anbieter, Modell und Gateway zusammenarbeiten. Im Terminal erledigt eine einzelne Nachricht denselben Check.

nanobot -m "Hello!"

Die Einstellungen landen in config.json im Ordner .nanobot in Ihrem Home-Verzeichnis. Wir haben diese Installation noch nicht auf unserer eigenen Testmaschine ausgeführt. Die Befehle hier stammen aus dem README und der Doku von nanobot, Stand 2. Oktober 2026.

Rund um die Uhr am Laufen halten

Das Gateway ist der Teil, der online bleibt. Es hält Chat-Apps, geplante Jobs und die Arbeit am Gedächtnis am Laufen. Dieser Befehl lässt es weiterlaufen, nachdem Sie das Terminal geschlossen haben.

nanobot gateway --background

Einen Neustart übersteht das nicht. Dafür installiert die Doku zum Deployment einen LaunchAgent. Schließen Sie zuerst die Einrichtung des Modells in der WebUI ab. Dann sehen Sie sich die Dienstdatei vorab an und installieren sie.

nanobot gateway install-service --manager launchd --dry-run
nanobot gateway install-service --manager launchd

Er schreibt ai.nanobot.gateway.plist in den Ordner LaunchAgents Ihrer Home-Library. Er startet das Gateway mit demselben Python, das nanobot installiert hat. Die Logs landen im Ordner logs in .nanobot. Scheitert er mit address already in use, stoppen Sie zuerst das Gateway, das Sie von Hand gestartet haben.

launchctl list | grep ai.nanobot.gateway
launchctl kickstart -k gui/$(id -u)/ai.nanobot.gateway
nanobot gateway uninstall-service --manager launchd

Das Gateway liest config.json nur beim Start. Starten Sie es nach jeder Änderung an der Konfiguration neu.

Ein LaunchAgent läuft nur, solange ein Benutzer angemeldet ist. Auf einem unbeaufsichtigten Mac aktivieren Sie die automatische Anmeldung für das Konto, unter dem nanobot läuft. Dann verhindern Sie den Ruhezustand. Der Ruhezustand pausiert das Gateway und seine geplanten Jobs.

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

Mehr Details stehen in was passiert, wenn ein Mac schläft und im Leitfaden für den dauerhaft eingeschalteten Mac.

Hinweise zur Sicherheit

• Für den Produktivbetrieb rät die Doku zu zwei Einstellungen zusammen. Setzen Sie restrictToWorkspace auf true und unter macOS tools.exec.sandbox auf seatbelt. Seatbelt beschränkt Shell-Befehle auf den Workspace-Ordner.
• Keine der beiden Einstellungen beschränkt den Netzwerkzugriff. Halten Sie Secrets außerhalb des Workspace.
• Die WebUI und der Health-Check des Gateways lauschen standardmäßig auf 127.0.0.1. Lassen Sie sie nur auf diesem Mac.
• Unbekannte Absender in Chat-Apps bekommen einen Pairing-Code, keine Antwort. Sie geben sie mit /pairing approve und ihrem Code frei.
• Die Doku empfiehlt Verweise auf Umgebungsvariablen für API-Keys statt roher Keys in config.json. So oder so: Behandeln Sie den Ordner .nanobot wie eine Passwortdatei.

Der einfachste Schutz ist ein Mac, auf dem sonst nichts von Ihnen liegt. Wenn der Agent etwas Seltsames tut, endet der Schaden an dieser Maschine.

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 startet der LaunchAgent von nanobot wieder. Claude Code und Codex sind vorinstalliert. nanobot nicht. Sie installieren es selbst, bei Bedarf zusammen mit Python, denn Sie haben volle Admin-Rechte.

Die WebUI können Sie im Browser des Mac selbst öffnen, über unseren Desktop im Browser. 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

nanobot ist klein und läuft fast überall. Die Doku behandelt Linux-Dienste, Docker und ein Deployment auf Render mit einem Klick. Wenn Sie nichts von macOS brauchen, kostet jede dieser Optionen weniger als ein Mac. Und wenn Sie schon einen Mac haben, der an und angemeldet bleibt, nutzen Sie den.

MacRun ist für Entwicklerarbeit unter unserer Richtlinie zur zulässigen Nutzung. Ein nanobot, der Issues sortiert oder nächtliche Aufgaben im Repo erledigt, passt. Einer, der Ihr privates Postfach verwaltet, passt nicht. Um die Tarife zu vergleichen, besuchen Sie die Seite zum Agent-Mac.