Inhaltsverzeichnis
Clawbox - OpenClaw-ready macOS VMs
Clawbox ist ein Tool zum Erstellen von OpenClaw-ready macOS Virtual Machines. Jede OpenClaw-Instanz läuft in ihrer eigenen isolierten VM, während OpenClaw selbst unverändert bleibt.
Repository: https://github.com/joshavant/clawbox Autor: joshavant Lizenz: MIT
Schnellstart
# Installation via Homebrew brew install joshavant/tap/clawbox # Base-Image erstellen (einmalig, dauert 10-30 Minuten) clawbox image build # VM starten clawbox up
Nach dem Start:
- Login:
clawbox - Passwort:
clawbox - Dann:
openclaw onboard –install-daemon
Voraussetzungen
| Anforderung | Details |
|---|---|
| macOS | arm64 (Apple Silicon) |
| Homebrew | brew.sh |
| Speicher | min. 30GB frei empfohlen |
| RAM | 8GB+ für 1 VM, 16GB+ für 2 VMs |
Apple Limit: Maximal 2 gleichzeitig laufende macOS-VMs pro Host.
Betriebsmodi
Standard-Modus
Installiert die neuste offizielle OpenClaw-Release in der VM.
clawbox up
Mit optionalen extras:
clawbox up \ --add-playwright-provisioning \ --add-tailscale-provisioning
Developer-Modus
Für OpenClaw-Entwicklung mit Host-Sync:
clawbox up --developer \ --openclaw-source ~/Developer/openclaw-1 \ --openclaw-payload ~/Developer/openclaw-payloads/clawbox-1
Features:
- Bidirektionales Sync via Mutagen
- Host-Source-Änderungen werden Live übernommen
- Mehrere parallele VMs möglich
Hot-Reload in der VM:
cd ~/Developer/openclaw pnpm gateway:watch
Optionale Extras
Playwright (''--add-playwright-provisioning'')
Installiert Playwright + alle Browser (Chromium, Firefox, WebKit).
Nutzen:
- Browser-Automatisierung
- Web-Scraping
- OpenClaw Canvas/Screenshot-Features
Speicher: +2-3GB für Browser
Tailscale (''--add-tailscale-provisioning'')
Installiert Tailscale VPN-Client in der VM.
Nutzen:
- Sicherer Remote-Zugriff von überall
- Kein Port-Forwarding nötig
- Private Network über alle Geräte
Hinweis: Erfordert interaktive Authorisierung in der VM nach der Erstellung.
signal-cli (''--add-signal-cli-provisioning'')
Installiert Signal CLI für automatisierte Signal-Nachrichten.
Nutzen:
- Signal-Bots
- OpenClaw als Signal-Brücke
Mit existierender Konfiguration:
clawbox up --developer \ --openclaw-source ~/Developer/openclaw-1 \ --openclaw-payload ~/Developer/openclaw-payloads/clawbox-1 \ --add-signal-cli-provisioning \ --signal-cli-payload ~/.local/share/signal-cli
Befehlsübersicht
Lifecycle
| Befehl | Beschreibung |
|---|---|
clawbox up | VM erstellen und starten |
clawbox down <n> | VM #n stoppen |
clawbox delete <n> | VM #n löschen |
clawbox recreate <n> | VM #n neu erstellen (mit ursprünglichen Flags) |
clawbox status | Alle VMs anzeigen |
clawbox status <n> | Details zu VM #n |
clawbox ip <n> | IP-Adresse von VM #n |
Image-Management
| Befehl | Beschreibung |
|---|---|
clawbox image init | Image initialisieren |
clawbox image build | Base-Image bauen (einmalig) |
clawbox image rebuild | Image neu bauen |
Manueller Workflow
clawbox create # VM erstellen clawbox launch # VM starten clawbox provision # VM konfigurieren
Mit –headless für provisioning ohne GUI-Fenster.
SSH-Zugang
ssh clawbox-1@$(clawbox ip 1) # Passwort: clawbox
Was Clawbox installiert
- Homebrew
- Node.js
- Mutagen (für Developer-Sync)
- OpenClaw
- Terminal.app Desktop-Shortcut
- SSH-Zugang
- macOS Defaults (Dark Mode, Siri aus, etc.)
- Tart Guest Agent (Clipboard-Sharing)
- Optionale Provisioning-Services
Empfehlungen
Für Produktiv-Nutzer
clawbox up --add-playwright-provisioning
Für Remote-Zugriff
clawbox up \ --add-playwright-provisioning \ --add-tailscale-provisioning
Für Entwickler
clawbox up --developer \ --openclaw-source ~/Developer/openclaw \ --openclaw-payload ~/Developer/openclaw-payloads/clawbox-dev
Troubleshooting
Sync-Status prüfen
clawbox status <n>
Sync-Logs
tail -n 80 ~/.clawbox/state/logs/sync-events.jsonl
VM neu starten
clawbox down <n> clawbox up --developer ... # mit ursprünglichen Flags
Locking-Modell
Clawbox erzwingt Single-Writer-Locking für:
–openclaw-source–openclaw-payload–signal-cli-payload
Wenn eine VM nicht mehr läuft, wird der Lock automatisch freigegeben.
Entwickler-Referenz
Repository: git clone https://github.com/joshavant/clawbox.git
# Lokale Installation zum Entwickeln brew install pipx pipx install --editable .
Host-Voraussetzungen:
brew tap cirruslabs/cli brew tap mutagen-io/mutagen brew install tart ansible mutagen
Links
— Klaus 2026/02/28 12:07