macOS-VMs

Empfohlene Standardeinstellung (die meisten Benutzer)

• Kleiner Linux-VPS für einen durchgehend aktiven Gateway zu niedrigen Kosten. Siehe VPS-Hosting.
• Dedizierte Hardware (Mac mini oder Linux-Rechner), wenn Sie volle Kontrolle und eine private IP-Adresse für Browser-Automatisierung möchten. Viele Websites blockieren IP-Adressen von Rechenzentren, daher funktioniert lokales Browsen oft besser.
• Hybrid: Lassen Sie den Gateway auf einem günstigen VPS laufen 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-exklusive Funktionen wie iMessage benötigen oder strikte Isolation von Ihrem täglich genutzten Mac wünschen.

macOS-VM-Optionen

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

Führen Sie OpenClaw in einer isolierten 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 imsg (der standardmäßige lokale Pfad ist unter Linux/Windows nicht möglich)
• Sofortiges Zurücksetzen durch Klonen von VMs
• Keine zusätzliche Hardware und keine Cloud-Kosten

Gehostete Mac-Provider (Cloud)

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

• MacStadium (gehostete Macs)
• Andere gehostete Mac-Anbieter 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.

Schnellweg (Lume, erfahrene Benutzer)

1. Lume installieren
2. lume create openclaw --os macos --ipsw latest
3. Einrichtungsassistent abschließen, Entfernte Anmeldung (SSH) aktivieren
4. lume run openclaw --no-display
5. Per SSH verbinden, OpenClaw installieren, Kanäle konfigurieren
6. Fertig

Was Sie benötigen (Lume)

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

1) Lume installieren

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

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

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

Überprüfen:

lume --version

Dokumentation: Lume-Installation

2) macOS-VM erstellen

lume create openclaw --os macos --ipsw latest

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

3) Einrichtungsassistent abschließen

Im VNC-Fenster:

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

Nachdem die Einrichtung abgeschlossen ist:

1. SSH aktivieren: Öffnen Sie Systemeinstellungen -> Allgemein -> Freigaben und aktivieren Sie „Entfernte Anmeldung“.
2. Für die Nutzung der VM ohne Anzeige aktivieren Sie die automatische Anmeldung: Öffnen Sie Systemeinstellungen -> Benutzer & Gruppen, wählen Sie „Automatisch anmelden als:“ und wählen Sie den VM-Benutzer.

4) IP-Adresse der VM abrufen

lume get openclaw

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

5) Per SSH mit der VM verbinden

ssh youruser@192.168.64.X

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

6) OpenClaw installieren

Innerhalb der VM:

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

Folgen Sie den Onboarding-Eingabeaufforderungen, um Ihren Modell-Provider (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-Code scannen):

openclaw channels login

8) VM ohne Anzeige ausführen

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

lume stop openclawlume run openclaw --no-display

Die VM läuft im Hintergrund. Der Daemon von OpenClaw hält den Gateway am Laufen.

Status prüfen:

ssh youruser@192.168.64.X "openclaw status"

Bonus: iMessage-Integration

Dies ist die wichtigste Funktion beim Betrieb unter macOS. Verwenden Sie iMessage mit imsg, um Nachrichten zu OpenClaw hinzuzufügen.

Innerhalb der VM:

1. Bei Nachrichten anmelden.
2. imsg installieren.
3. Vollzugriff auf die Festplatte und Automatisierungsberechtigungen für den Prozess gewähren, der OpenClaw/imsg ausführt.
4. RPC-Unterstützung mit imsg rpc --help überprüfen.

Fügen Sie Folgendes zu Ihrer OpenClaw-Konfiguration hinzu:

{  channels: {    imessage: {      enabled: true,      cliPath: "imsg",      dbPath: "~/Library/Messages/chat.db",    },  },}

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

Vollständige Einrichtungsdetails: iMessage-Kanal

Golden Image speichern

Erstellen Sie einen Snapshot Ihres sauberen Zustands, bevor Sie weitere Anpassungen vornehmen:

lume stop openclawlume clone openclaw openclaw-golden

Jederzeit zurücksetzen:

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

Rund um die Uhr ausführen

Halten Sie die VM am Laufen, indem Sie:

• Ihren Mac am Strom angeschlossen lassen
• den Ruhezustand in Systemeinstellungen → Energie sparen deaktivieren
• bei Bedarf caffeinate verwenden

Für echten Dauerbetrieb sollten Sie einen dedizierten Mac mini oder einen kleinen VPS in Betracht ziehen. Siehe VPS-Hosting.

Fehlerbehebung

Verwandte Dokumentation

• VPS-Hosting
• Nodes
• Gateway remote
• iMessage-Kanal
• Lume-Schnellstart
• Lume-CLI-Referenz
• Unbeaufsichtigte VM-Einrichtung (fortgeschritten)
• Docker-Sandboxing (alternativer Isolationsansatz)