OpenClaw auf macOS-VMs (Sandboxing)¶

Empfohlener Standard (für die meisten Nutzer)¶

Kleiner Linux-VPS für ein dauerhaft laufendes Gateway und geringe Kosten. Siehe VPS hosting.
Dedizierte Hardware (Mac mini oder Linux-Box), wenn Sie volle Kontrolle und eine Residential IP für Browser-Automatisierung möchten. Viele Websites blockieren Rechenzentrums-IP-Adressen, daher funktioniert lokales Browsen oft besser.
Hybrid: Betreiben Sie das Gateway auf einem günstigen VPS und verbinden Sie Ihren Mac als Node, wenn Sie Browser-/UI-Automatisierung benötigen. Siehe Nodes und Gateway remote.

Verwenden Sie eine macOS-VM, wenn Sie gezielt macOS-spezifische Funktionen (iMessage/BlueBubbles) benötigen oder eine strikte Isolation von Ihrem täglichen Mac wünschen.

macOS-VM-Optionen¶

Lokale VM auf Ihrem Apple-Silicon-Mac (Lume)¶

Führen Sie OpenClaw in einer sandboxed macOS-VM auf Ihrem vorhandenen Apple-Silicon-Mac mit Lume aus.

Das bietet Ihnen:

Vollständige macOS-Umgebung in Isolation (Ihr Host bleibt sauber)
iMessage-Unterstützung über BlueBubbles (auf Linux/Windows unmöglich)
Sofortiges Zurücksetzen durch Klonen von VMs
Keine zusätzliche Hardware oder Cloud-Kosten

Gehostete Mac-Anbieter (Cloud)¶

Wenn Sie macOS in der Cloud möchten, funktionieren gehostete Mac-Anbieter ebenfalls:

MacStadium (gehostete Macs)
Andere Anbieter für gehostete Macs funktionieren ebenfalls; folgen Sie deren VM- und SSH-Dokumentation

Sobald Sie SSH-Zugriff auf eine macOS-VM haben, fahren Sie unten mit Schritt 6 fort.

Schneller Weg (Lume, erfahrene Nutzer)¶

Lume installieren
lume create openclaw --os macos --ipsw latest
Setup-Assistent abschließen, „Remote Login“ (SSH) aktivieren
lume run openclaw --no-display
Per SSH einloggen, OpenClaw installieren, Kanäle konfigurieren
Fertig

Was du brauchst (Lume)¶

Apple-Silicon-Mac (M1/M2/M3/M4)
macOS Sequoia oder neuer auf dem Host
~60 GB freier Speicherplatz pro VM
~20 Minuten

1. Lume installieren¶

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

Falls ~/.local/bin nicht in Ihrem PATH ist:

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

Überprüfen:

lume --version

Doku: Lume Installation

2. Die macOS-VM erstellen¶

lume create openclaw --os macos --ipsw latest

Dadurch wird macOS heruntergeladen und die VM erstellt. Ein VNC-Fenster öffnet sich automatisch.

Hinweis: Der Download kann je nach Verbindung eine Weile dauern.

3. Setup-Assistent abschließen¶

Im VNC-Fenster:

Sprache und Region auswählen
Apple-ID überspringen (oder anmelden, wenn Sie später iMessage möchten)
Benutzerkonto erstellen (Benutzername und Passwort merken)
Alle optionalen Funktionen überspringen

Nach Abschluss der Einrichtung SSH aktivieren:

Systemeinstellungen → Allgemein → Teilen öffnen
„Remote Login“ aktivieren

4. IP-Adresse der VM ermitteln¶

lume get openclaw

Suchen Sie nach der IP-Adresse (meist 192.168.64.x).

5. Per SSH in die VM einloggen¶

ssh youruser@192.168.64.X

Ersetzen Sie youruser durch das von Ihnen erstellte Konto und die IP durch die IP Ihrer VM.

6. OpenClaw installieren¶

Innerhalb der VM:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Folgen Sie den Onboarding-Aufforderungen, um Ihren Modellanbieter (Anthropic, OpenAI usw.) einzurichten.

7. Kanäle konfigurieren¶

Bearbeiten Sie die Konfigurationsdatei:

nano ~/.openclaw/openclaw.json

Fügen Sie Ihre Kanäle hinzu:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    },
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Melden Sie sich dann bei WhatsApp an (QR scannen):

openclaw channels login

8. Die VM headless ausführen¶

Beenden Sie die VM und starten Sie sie ohne Anzeige neu:

lume stop openclaw
lume run openclaw --no-display

Die VM läuft im Hintergrund. Das OpenClaw-Daemon hält das Gateway am Laufen.

Status prüfen:

ssh youruser@192.168.64.X "openclaw status"

Bonus: iMessage-Integration¶

Dies ist das Killer-Feature beim Betrieb unter macOS. Verwenden Sie BlueBubbles, um iMessage zu OpenClaw hinzuzufügen.

Innerhalb der VM:

BlueBubbles von bluebubbles.app herunterladen
Mit Ihrer Apple-ID anmelden
Die Web-API aktivieren und ein Passwort festlegen
BlueBubbles-Webhooks auf Ihr Gateway verweisen (Beispiel: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Zur OpenClaw-Konfiguration hinzufügen:

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

Starten Sie das Gateway neu. Jetzt kann Ihr Agent iMessages senden und empfangen.

Vollständige Setup-Details: BlueBubbles channel

Golden Image speichern¶

Bevor Sie weiter anpassen, erstellen Sie einen Snapshot Ihres sauberen Zustands:

lume stop openclaw
lume clone openclaw openclaw-golden

Jederzeit zurücksetzen:

lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

Läuft rund um die Uhr¶

Halten Sie die VM am Laufen durch:

Ihren Mac am Strom lassen
Ruhezustand in Systemeinstellungen → Energie sparen deaktivieren
Falls nötig caffeinate verwenden

Für echten Dauerbetrieb erwägen Sie einen dedizierten Mac mini oder einen kleinen VPS. Siehe VPS hosting.

Fehlerbehebung¶

Problem	Lösung
Kein SSH-Zugriff auf VM	Prüfen Sie, ob „Remote Login“ in den Systemeinstellungen der VM aktiviert ist
VM-IP wird nicht angezeigt	Warten Sie, bis die VM vollständig gebootet ist, und führen Sie `lume get openclaw` erneut aus
Lume-Befehl nicht gefunden	Fügen Sie `~/.local/bin` zu Ihrem PATH hinzu
WhatsApp-QR scannt nicht	Stellen Sie sicher, dass Sie beim Ausführen von `openclaw channels login` in der VM (nicht auf dem Host) angemeldet sind

Other install methods

macOS VMs