OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

macOS-VMs

Empfohlene Standardeinstellung (für die meisten Benutzer)

  • Kleiner Linux-VPS für einen ständig verfügbaren Gateway zu niedrigen Kosten. Siehe VPS-Hosting.
  • Dedizierte Hardware (Mac mini oder Linux-Rechner), wenn Sie vollständige Kontrolle und eine private IP-Adresse für die Browserautomatisierung wünschen. Viele Websites blockieren IP-Adressen von Rechenzentren, daher funktioniert lokales Browsen häufig besser.
  • Hybrid: Betreiben Sie den Gateway auf einem günstigen VPS und verbinden Sie Ihren Mac als Node, wenn Sie Browser-/UI-Automatisierung benötigen. Siehe Nodes und Gateway aus der Ferne.

Verwenden Sie eine macOS-VM nur, wenn Sie ausdrücklich Funktionen benötigen, die ausschließlich unter macOS verfügbar sind, etwa iMessage, oder wenn Sie eine strikte Trennung von Ihrem täglich verwendeten Mac wünschen.

Optionen für macOS-VMs

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

Führen Sie OpenClaw mit Lume in einer isolierten macOS-VM auf Ihrem vorhandenen Apple-Silicon-Mac aus. Dies bietet Ihnen:

  • Vollständige macOS-Umgebung in Isolation (Ihr Host bleibt unverändert)
  • 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 nutzen möchten, funktionieren auch gehostete Mac-Provider:

  • MacStadium (gehostete Macs)
  • Andere Anbieter gehosteter Macs funktionieren ebenfalls; folgen Sie deren Dokumentation zu VMs und SSH

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

Schnellverfahren (Lume, erfahrene Benutzer)

  1. Installieren Sie Lume.
  2. lume create openclaw --os macos --ipsw latest
  3. Schließen Sie den Systemassistenten ab und aktivieren Sie Remote Login (SSH).
  4. lume run openclaw --no-display
  5. Stellen Sie eine SSH-Verbindung her, installieren Sie OpenClaw und konfigurieren Sie die Kanäle.
  6. Fertig.

Voraussetzungen (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

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

Wenn sich ~/.local/bin nicht in Ihrem PATH befindet:

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

Überprüfen Sie die Installation:

bash
lume --version

Dokumentation: Lume-Installation

2) macOS-VM erstellen

bash
lume create openclaw --os macos --ipsw latest

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

3) Systemassistenten abschließen

Im VNC-Fenster:

  1. Wählen Sie Sprache und Region aus.
  2. Überspringen Sie die Apple-ID (oder melden Sie sich an, wenn Sie später iMessage verwenden möchten).
  3. Erstellen Sie ein Benutzerkonto (merken Sie sich Benutzername und Passwort).
  4. Überspringen Sie alle optionalen Funktionen.

Nach Abschluss der Einrichtung:

  1. Aktivieren Sie SSH: System Settings -> General -> Sharing, und aktivieren Sie "Remote Login".
  2. Aktivieren Sie für den Betrieb der VM ohne Anzeige die automatische Anmeldung: System Settings -> Users & Groups, wählen Sie "Automatically log in as:" und anschließend den VM-Benutzer aus.

4) IP-Adresse der VM abrufen

bash
lume get openclaw

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

5) Per SSH mit der VM verbinden

bash
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:

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

Folgen Sie den Einrichtungsaufforderungen, um Ihren Modell-Provider (Anthropic, OpenAI usw.) einzurichten.

7) Kanäle konfigurieren

Bearbeiten Sie die Konfigurationsdatei:

bash
nano ~/.openclaw/openclaw.json

Fügen Sie Ihre Kanäle hinzu:

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

Melden Sie sich anschließend bei WhatsApp an (QR-Code scannen):

bash
openclaw channels login

8) VM ohne Anzeige ausführen

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

bash
lume stop openclawlume run openclaw --no-display

Die VM wird im Hintergrund ausgeführt; der Daemon von OpenClaw hält den Gateway in Betrieb. So prüfen Sie den Status:

bash
ssh youruser@192.168.64.X "openclaw status"

Bonus: iMessage-Integration

Dies ist der entscheidende Vorteil der Ausführung unter macOS. Verwenden Sie iMessage mit imsg, um Nachrichten zu OpenClaw hinzuzufügen.

Innerhalb der VM:

  1. Melden Sie sich bei Nachrichten an.
  2. Installieren Sie imsg.
  3. Gewähren Sie dem Prozess, der OpenClaw/imsg ausführt, Festplattenvollzugriff und die Berechtigung zur Automation.
  4. Überprüfen Sie die RPC-Unterstützung mit imsg rpc --help.

Fügen Sie Ihrer OpenClaw-Konfiguration Folgendes hinzu:

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

Starten Sie den Gateway neu. Ihr Agent kann nun iMessages senden und empfangen. Ausführliche Einrichtungsinformationen: iMessage-Kanal.

Golden Image speichern

Erstellen Sie vor weiteren Anpassungen einen Snapshot Ihres unveränderten Zustands:

bash
lume stop openclawlume clone openclaw openclaw-golden

Jederzeit zurücksetzen:

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

24/7 ausführen

Halten Sie die VM in Betrieb, indem Sie:

  • Ihren Mac an die Stromversorgung angeschlossen lassen
  • den Ruhezustand unter System Settings -> Energy Saver deaktivieren
  • bei Bedarf caffeinate verwenden

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

Fehlerbehebung

Problem Lösung
Keine SSH-Verbindung zur VM Prüfen Sie, ob "Remote Login" in den System Settings der VM aktiviert ist
VM-IP wird nicht angezeigt Warten Sie, bis die VM vollständig gestartet ist, und führen Sie lume get openclaw erneut aus
Lume-Befehl nicht gefunden Fügen Sie ~/.local/bin Ihrem PATH hinzu
WhatsApp-QR wird nicht erkannt Stellen Sie sicher, dass Sie bei der Ausführung von openclaw channels login an der VM (nicht am Host) angemeldet sind

Verwandte Dokumentation

Was this useful?
On this page

On this page