OpenClaw auf macOS VMs (Sandboxing)

Empfohlene Standardlösung (für die meisten)

• Kleiner Linux VPS für ein dauerhaft laufendes Gateway zu niedrigen Kosten. Siehe VPS-Hosting.
• Dedizierte Hardware (Mac mini oder Linux-Box), wenn du volle Kontrolle und eine Privat-IP für Browser-Automatisierung willst. Viele Websites blockieren Rechenzentrum-IPs, daher funktioniert lokales Browsing oft besser.
• Hybrid: Gateway auf einem günstigen VPS laufen lassen und deinen Mac als Node verbinden, wenn du Browser/UI-Automatisierung brauchst. Siehe Nodes und Gateway remote.

Nutze eine macOS-VM, wenn du speziell macOS-exklusive Funktionen (iMessage/BlueBubbles) brauchst oder strikte Isolation von deinem täglichen Mac willst.

macOS-VM-Optionen

Lokale VM auf deinem Apple Silicon Mac (Lume)

Führe OpenClaw in einer isolierten macOS-VM auf deinem vorhandenen Apple Silicon Mac aus – mit Lume.

Das bringt dir:

• Vollständige macOS-Umgebung in Isolation (dein Host bleibt sauber)
• iMessage-Support via BlueBubbles (auf Linux/Windows unmöglich)
• Sofortiges Zurücksetzen durch VM-Klonen
• Keine zusätzliche Hardware oder Cloud-Kosten

Gehostete Mac-Anbieter (Cloud)

Wenn du macOS in der Cloud willst, funktionieren gehostete Mac-Anbieter auch:

• MacStadium (gehostete Macs)
• Andere gehostete Mac-Anbieter funktionieren ebenfalls; folge deren VM + SSH-Dokumentation

Sobald du SSH-Zugriff auf eine macOS-VM hast, mach weiter bei Schritt 6 unten.

Schnellweg (Lume, erfahrene Nutzer)

1. Lume installieren
2. lume create openclaw --os macos --ipsw latest
3. Setup Assistant abschließen, Remote Login (SSH) aktivieren
4. lume run openclaw --no-display
5. Per SSH einloggen, OpenClaw installieren, Channels konfigurieren
6. 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 deinem PATH ist:

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

Prüfen:

lume --version

Docs: Lume Installation

2) macOS-VM erstellen

lume create openclaw --os macos --ipsw latest

Das lädt macOS herunter und erstellt die VM. Ein VNC-Fenster öffnet sich automatisch.

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

3) Setup Assistant abschließen

Im VNC-Fenster:

1. Sprache und Region auswählen
2. Apple ID überspringen (oder anmelden, wenn du später iMessage willst)
3. Benutzerkonto erstellen (merke dir Benutzername und Passwort)
4. Alle optionalen Features überspringen

Nach Abschluss des Setups SSH aktivieren:

1. Systemeinstellungen öffnen → Allgemein → Freigaben
2. “Remote-Anmeldung” aktivieren

4) IP-Adresse der VM ermitteln

lume get openclaw

Schau nach der IP-Adresse (normalerweise 192.168.64.x).

5) Per SSH in die VM einloggen

ssh [email protected]

Ersetze youruser mit dem Konto, das du erstellt hast, und die IP mit der IP deiner VM.

6) OpenClaw installieren

In der VM:

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

Folge den Onboarding-Prompts, um deinen Model Provider einzurichten (Anthropic, OpenAI, etc.).

7) Channels konfigurieren

Config-Datei bearbeiten:

nano ~/.openclaw/openclaw.json

Channels hinzufügen:

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

Dann bei WhatsApp einloggen (QR-Code scannen):

openclaw channels login

8) VM headless laufen lassen

VM stoppen und ohne Display neu starten:

lume stop openclaw
lume run openclaw --no-display

Die VM läuft im Hintergrund. OpenClaws Daemon hält das Gateway am Laufen.

Status prüfen:

ssh [email protected] "openclaw status"

Bonus: iMessage-Integration

Das ist das Killer-Feature beim Betrieb auf macOS. Nutze BlueBubbles, um iMessage zu OpenClaw hinzuzufügen.

In der VM:

1. BlueBubbles von bluebubbles.app herunterladen
2. Mit deiner Apple ID anmelden
3. Web API aktivieren und Passwort setzen
4. BlueBubbles-Webhooks auf dein Gateway richten (Beispiel: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Zu deiner OpenClaw-Config hinzufügen:

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

Gateway neu starten. Jetzt kann dein Agent iMessages senden und empfangen.

Vollständige Setup-Details: BlueBubbles Channel

Golden Image speichern

Bevor du weiter anpasst, erstelle einen Snapshot deines 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

24/7 laufen lassen

Halte die VM am Laufen, indem du:

• Deinen Mac am Strom lässt
• Ruhezustand in Systemeinstellungen → Energie deaktivierst
• Bei Bedarf caffeinate verwendest

Für echtes Always-on erwäge einen dedizierten Mac mini oder einen kleinen VPS. Siehe VPS-Hosting.

Troubleshooting

Verwandte Docs

• VPS-Hosting
• Nodes
• Gateway remote
• BlueBubbles Channel
• Lume Quickstart
• Lume CLI Reference
• Unattended VM Setup (advanced)
• Docker Sandboxing (alternative Isolationsmethode)