So installieren Sie OpenClaw auf einem Mac mini

Was OpenClaw ist

OpenClaw ist ein Open-Source-KI-Assistent, der auf Ihrem eigenen Computer läuft. Sie sprechen mit ihm über Chat-Apps, die Sie schon nutzen. Das README nennt Discord, iMessage, Slack, Teams, Telegram und WhatsApp sowie mehr als 20 weitere (github.com/openclaw/openclaw, Oktober 2026).

Das Kernstück ist das Gateway. Es ist ein lang laufender Prozess, der Ihre Chat-Verbindungen hält und den Agent ausführt. Stoppt das Gateway, antwortet der Assistent nicht mehr. Deshalb ist die Maschine, auf der es läuft, wichtiger als die Installation.

Voraussetzungen

• Node 24.16 oder neuer, oder Node 26.1 oder neuer. Fehlt Node, installiert der Installer unter macOS Node 26 (docs.openclaw.ai/install, Oktober 2026).
• Ein Modellanbieter. OpenClaw übernimmt beim Onboarding einen API-Key des Anbieters, den Sie wählen.
• Ein beliebiger Mac mit Apple Silicon. Die Doku nennt kein Minimum für den Arbeitsspeicher. Mit einem Cloud-Modell sind 16 GB reichlich. Ein lokales Modell ist eine andere Sache. Das behandelt unser Leitfaden zu lokalen LLMs.

Installation

Führen Sie den offiziellen Installer im Terminal aus.

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

Wenn er fertig ist, führt er Sie ins Onboarding. Wollen Sie erst installieren und später einrichten, nennt die Doku ein Flag, das das Onboarding überspringt. Dann starten Sie das Onboarding selbst, mit der Option für den Dienst.

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
openclaw onboard --install-daemon

Wir haben den Installer am 2. Oktober 2026 auf einer frischen, von GitHub gehosteten Maschine mit macOS 26 ausgeführt. Node war schon vorhanden, daher dauerte es etwa 25 Sekunden. Das gab die Versionsprüfung aus.

$ openclaw --version
OpenClaw 2026.9.7 (c074824)

Prüfen Sie dann Installation und Dienst mit den dokumentierten Befehlen.

openclaw doctor
openclaw gateway status

Auf unserer Testmaschine meldete doctor vor dem Onboarding drei Punkte. Der Gateway-Modus war nicht gesetzt. Die Gateway-Authentifizierung hatte keinen Token. Und es war kein Command Owner festgelegt. Führen Sie doctor nach dem Onboarding erneut aus und beheben Sie, was übrig ist. Nehmen Sie den Owner ernst. Laut doctor ist das das Konto, das die Konfiguration ändern, das Gateway neu starten und Befehle freigeben darf.

Rund um die Uhr am Laufen halten

Die Option für den Dienst installiert einen LaunchAgent. Laut Doku heißt sein Label ai.openclaw.gateway, die Datei ai.openclaw.gateway.plist liegt im Ordner LaunchAgents Ihrer Home-Library. launchd startet ihn bei der Anmeldung und startet ihn nach einem Absturz neu. Die Logs landen in einer Datei.

openclaw gateway status --deep
openclaw gateway restart
openclaw health
tail -f ~/Library/Logs/openclaw/gateway.log

Sie können den Dienst auch allein installieren, ohne Onboarding. Das haben wir auf einer zweiten Testmaschine getan. Wir haben den Gateway-Modus auf local gesetzt, doctor einen Token erzeugen lassen und den Installationsbefehl ausgeführt.

openclaw config set gateway.mode local
openclaw doctor --fix --generate-gateway-token
openclaw gateway install

Etwa 15 Sekunden später zeigte der Statusbefehl den Dienst als aktiv.

$ openclaw gateway status
Service file: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Gateway: bind=loopback (127.0.0.1), port=18789 (service args)
Dashboard: http://127.0.0.1:18789/
Gateway version: 2026.9.7
Runtime: running (pid 16165, state active)
Connectivity probe: ok
Listening: 127.0.0.1:18789

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 OpenClaw läuft. Dann verhindern Sie den Ruhezustand. Der Ruhezustand friert das Gateway ein und trennt jede Chat-Verbindung.

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

Die Gründe und die Regeln für den Laptop-Deckel 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

• Bei einer normalen Installation lauscht das Gateway nur auf Loopback. Lassen Sie es so. Um das Dashboard von Ihrem Laptop aus zu erreichen, nutzt die Doku einen SSH-Tunnel.
• Unbekannte Absender in Direktnachrichten bekommen einen Pairing-Code, keine Antwort. Sie geben sie mit dem Pairing-Befehl unten frei.
• Tools laufen standardmäßig auf dem Host, sofern Sie kein Sandboxing einrichten. Der Agent kann alles anfassen, was dieser macOS-Benutzer anfassen kann.
• Secrets liegen auf der Festplatte im Zustandsordner von OpenClaw, die Konfiguration in openclaw.json darin. Behandeln Sie diesen Ordner wie eine Passwortdatei.
• Führen Sie nach jeder Änderung an der Konfiguration das eingebaute Audit aus. Auf unserer frischen Testinstallation meldete es 0 kritische Punkte, 1 Warnung und 1 Hinweis.

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
openclaw pairing approve <channel> <code>
openclaw security audit

Der einfachste Schutz ist physisch. Lassen Sie OpenClaw auf einem Mac laufen, auf dem sonst nichts von Ihnen liegt. Keine persönliche Apple ID, kein Passwortmanager, kein Browser voller Logins. 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. Seine Anmeldesitzung kommt nach einem Neustart von selbst zurück, also starten LaunchAgents wieder. Claude Code und Codex sind installiert. OpenClaw ist nicht vorinstalliert. Sie installieren es selbst mit den Befehlen oben, denn Sie haben volle Admin-Rechte. OpenClaw braucht einen API-Key des Modellanbieters, den Sie beim Onboarding wählen.

Wer uns dafür nicht nutzen sollte. MacRun ist für Entwicklerarbeit unter unserer Richtlinie zur zulässigen Nutzung. Ein OpenClaw, das Code schreibt, die CI beobachtet oder Issues sortiert, passt. Eines, das Ihre privaten E-Mails und den Familienkalender verwaltet, passt nicht. Außerdem läuft OpenClaw unter Linux. Wenn Sie nichts von macOS brauchen, kostet ein kleiner Linux-Server weniger als jeder Mac.

Bereit, es auf einer Maschine zu testen, die an bleibt? Vergleichen Sie die Tarife auf der Seite zum Agent-Mac.