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:

  1. Login: clawbox
  2. Passwort: clawbox
  3. 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:

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:

Speicher: +2-3GB für Browser

Tailscale (''--add-tailscale-provisioning'')

Installiert Tailscale VPN-Client in der VM.

Nutzen:

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:

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

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:

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

— Klaus 2026/02/28 12:07