Erste Frage: Warum Agents nicht direkt auf barem macOS laufen lassen?
Viele Teams starten mit dem Gedanken: „Ist nur ein Test – per SSH auf den Cloud-Mac und den Agent arbeiten lassen."
Das Problem: Moderne Agent-Frameworks (LangGraph, AutoGen, Cursor Background Agent und ähnliche) führen Tool-Aufrufe als aktueller Benutzer aus –
Dateizugriffe, Kindprozesse, Netzwerk – alles mit derselben Grenze wie Ihre eigene Terminal-Sitzung.
In einem internen Pilot baten wir einen Agent, ein Swift-Repo zu scannen und Compile-Warnungen automatisch zu beheben;
in der dritten Iteration versuchte er, ~/Library/Keychains zu lesen und security find-identity auszuführen,
um „beim Finden von Signierzertifikaten zu helfen." Nachvollziehbare Absicht – katastrophal auf einer Build-Maschine mit Distribution-Zertifikaten.
Konten wechseln oder nach jeder Aufgabe neu aufsetzen ist teuer; Docker auf macOS deckt nicht die volle Xcode-Toolchain ab.
OpenClaws Ansatz: Der Agent läuft weiterhin auf echtem macOS (xcodebuild und Apple Neural Engine funktionieren),
aber jeder Systemaufruf passiert zuerst eine Policy-Engine – bei Verstoß Ablehnung, alles ins Audit-Log.
Für Teams mit Compliance-Anforderungen (DSGVO, interne Sicherheitsrichtlinien) ist das entscheidend:
Sie können nachweisen, welche Pfade ein Agent angefasst hat und welche Aktionen explizit blockiert wurden – ohne den gesamten Build-Node offline zu nehmen.
Dieser Artikel deckt nur den kürzesten Weg von null bis zur funktionierenden Sandbox-Aufgabe; Architektur, Multi-User-Zero-Trust und CI-Verdrahtung stehen in der
OpenClaw Komplettanleitung.
Hardware: Mac mini M4 · 10-Kern-CPU · 16 GB Unified Memory · 256 GB NVMe · 1 Gbps dedizierte Bandbreite (PixVPS Hongkong-Node).
OS: macOS 15 Sequoia. OpenClaw CLI 0.9.4, Policy-Format v2.
Beispielaufgabe: Agent klont ein öffentliches Repo → scannt TODO-Kommentare mit rg → schreibt einen Markdown-Bericht (lesefokussiert, kein ausgehendes Netzwerk).
Gesamter Ablauf per SSH; VNC nicht verwendet.
Vorbereitung: Drei Dinge, die Sie brauchen
Sie benötigen keinen lokalen Mac – ein Windows- oder Linux-Laptop mit SSH reicht. Bestätigen Sie diese drei Punkte vor dem Start, sonst bleiben Sie mittendrin stecken:
Cloud-Node: Falls noch keine Instanz vorhanden, Region und Laufzeit auf der Bestellseite wählen.
Alle fünf Nodes (Singapur, Japan Tokio, Südkorea Seoul, Hongkong, USA Ost) haben identische Hardware und Preise – nach Latenz wählen.
SSH-Zugangsdaten erscheinen in der Konsole innerhalb von 1–5 Minuten nach Zahlung.
instance-token: Wird beim ersten Aktivieren von OpenClaw unter „Sicherheit & Sandbox" in der Konsole erzeugt; wird einmal angezeigt – sofort im Team-Secrets-Vault speichern.
Policy-Datei: Abschnitt 4 liefert eine Copy-Paste-Vorlage mit Lese-Fokus; speichern als ~/policies/quickstart-readonly.yaml.
Fünf-Minuten-Ablauf: Von der Aktivierung bis zur ersten Sandbox-Aufgabe
Die Zeiten unten spiegeln unsere Messungen wider. Wir wiederholten den Ablauf fünfmal auf einem Singapur-Node; bei Routine dauerte der Gesamtlauf etwa 4 Minuten 20 Sekunden. Beim ersten Versuch 5–8 Minuten einplanen. Jeder Schritt hat eine klare Abnahmeprüfung – erst weiter, wenn die erwartete Ausgabe erscheint. Nutzer in Mitteleuropa können alternativ den USA-Ost- oder Hongkong-Node wählen; die Hardware ist identisch, nur die SSH-Latenz unterscheidet sich – für diesen Quickstart spielt das keine Rolle.
-
01
Minute 1: OpenClaw in der Konsole aktivieren
In die PixVPS-Konsole einloggen → Instanzdetails → „Sicherheit & Sandbox" → OpenClaw einschalten. Den
instance-tokenin 1Password oder Bitwarden kopieren. Fertig, wenn: Die Seite OpenClaw-Status „aktiviert" anzeigt. -
02
Minute 2: Per SSH einloggen und CLI installieren
SSH-Befehl aus „Zugangsinformationen" in der Konsole kopieren, auf der Instanz einloggen, dann Install-Skript ausführen und authentifizieren. Fertig, wenn:
openclaw statusPolicy Engine, Sandbox Runtime und Audit Bus alle alshealthymeldet. -
03
Minute 3: Minimale Read-only-Policy schreiben
~/policies/anlegen, YAML aus Abschnitt 4 einfügen.openclaw policy validate -f ~/policies/quickstart-readonly.yamlzur Syntaxprüfung ausführen. Fertig, wenn: Ausgabepolicy validohne Pfad-Konflikt-Warnungen. -
04
Minute 4: Sandbox erstellen und testen
openclaw sandbox create --name quickstart --policy ~/policies/quickstart-readonly.yaml, dannopenclaw sandbox exec quickstart -- /bin/zsh -lc 'ls -la /workspace'. Fertig, wenn: Leeres Workspace-Verzeichnislisting in der Sandbox sichtbar, ohne Berechtigungsfehler. -
05
Minute 5: Agent-Einstiegsskript ausführen und Audit verfolgen
Agent-Einstieg (oder Beispielskript unten) in der Sandbox ausführen. In einem zweiten Terminal
openclaw audit tail --sandbox quickstart --followfür Live-Logs. Nach Abschlussopenclaw sandbox stop quickstart. Fertig, wenn: Audit-Logsdecision: allowunddecision: denyenthalten (falls der Agent blockierte Pfade traf).
In der SSH-Sitzung der Instanz ausführen:
curl -fsSL https://api.pixvps.com/openclaw/install.sh | bash
openclaw auth login --token <instance-token>
openclaw status
Minimales Berechtigungs-YAML: Read-only-Code-Scan-Vorlage
Quickstart-Regel: streng starten, später lockern. Die erste Policy soll nur das freigeben, was der Agent braucht.
Die Vorlage unten erlaubt Lese-/Schreibzugriff auf /workspace, führt git / rg / python3 aus, blockiert Keychain- und SSH-Pfade und verweigert ausgehendes Netzwerk –
ausreichend für „öffentliches Repo klonen → statischer Scan → Bericht schreiben".
apiVersion: openclaw.pixvps.com/v2
kind: SandboxPolicy
metadata:
name: quickstart-readonly
spec:
filesystem:
allow:
- path: /workspace
access: [read, write]
deny:
- path: "**/Keychains/**"
- path: "**/.ssh/**"
process:
allow: [git, rg, python3, zsh]
network:
egress: deny-all
Hinweis: /workspace enthält Schreibzugriff, weil der Agent den Scan-Bericht persistieren muss;
für rein lesende Aufgaben access auf [read] setzen.
Für Code von GitHub network.egress auf allow-list umstellen und github.com:443 hinzufügen –
der häufigste „Schritt zwei" nach dem Quickstart. Vollständige Netzwerk-Whitelist-Muster stehen in
Abschnitt 5 der Komplettanleitung.
Erste Agent-Aufgabe ausführen: Copy-Paste-Einstiegsskript
Bevor Sie LangGraph oder einen eigenen Orchestrator verdrahten, validieren Sie die Schleife „Policy + Sandbox + Audit" mit einem ~20-zeiligen Shell-Skript.
Folgendes als /workspace/agent-entry.sh auf dem Host speichern (das Verzeichnis wird automatisch in die Sandbox gemappt):
#!/bin/zsh
set -euo pipefail
cd /workspace
git clone --depth 1 https://github.com/apple/swift-sample-code.git repo 2>/dev/null || true
rg -n "TODO|FIXME" repo/ > scan-report.txt || true
echo "Scan done: $(wc -l < scan-report.txt) matches" > summary.txt
cat summary.txt
Bei weiterhin aktivem egress: deny-all wird git clone von der Netzwerk-Policy blockiert –
beabsichtigt für die Demo: Audit verfolgen und Sie sehen einen decision: deny-Netzwerkeintrag.
GitHub zur Allow-List hinzufügen und erneut ausführen; dann decision: allow und erfolgreiche summary.txt.
Ausführen:
openclaw sandbox exec quickstart -- /bin/zsh /workspace/agent-entry.sh.
Auf unserem M4-Node dauerte das Skript (inkl. Klon) etwa 38 Sekunden; kumulierter Policy-Evaluations-Overhead unter 200 ms – vernachlässigbar.
Nach Abschluss openclaw sandbox stop quickstart ausführen, um den Workspace freizugeben; Zombie-Sandboxes belegen Platte – Standard-Obergrenze pro Instanz sind fünf gleichzeitige Sitzungen.
Wenn Sie den Audit-Export archivieren möchten, leitet openclaw audit export --sandbox quickstart --format jsonl die Logs in eine Datei um – nützlich für spätere Compliance-Prüfungen oder Ticket-Anhänge.
Drei typische Blocker und Einzeiler-Fixes
Beim ersten Lauf trifft fast jeder einen dieser Punkte. Kein langes Handbuch nötig – die Tabelle reicht.
| Symptom | Wahrscheinliche Ursache | Einzeiler-Fix |
|---|---|---|
openclaw auth login meldet ungültigen Token |
Leerzeichen beim Kopieren oder Token wurde rotiert | Erneut aus der Konsole kopieren; alte Tokens werden nach Rotation sofort ungültig |
Agent liefert E_POLICY_DENY: filesystem |
Pfad nicht auf der Allow-List | openclaw audit query --decision deny --since 1h für den Pfad, dann YAML anpassen |
git clone schlägt ohne Dateifehler fehl |
Netzwerk-Policy ist deny-all | network.egress auf allow-list setzen und github.com:443 hinzufügen |
instance-token nicht in Git committen oder in Slack-Screenshots einfügen.
Nach dem Pilot, wenn mehrere Teammitglieder Zugang brauchen, Zero-Trust-Gerätezertifikate und Rollen Viewer / Operator / Admin in der Konsole konfigurieren –
siehe Abschnitt 6 der Komplettanleitung.
Nach dem Pilot: Berechtigungen erweitern und in Ihrem Tempo skalieren
Eine fünfminütige Read-only-Sandbox ist nur der Anfang. Reale Workloads brauchen oft xcodebuild, npm-Registry-Zugriff
und eine frische Sandbox bei jedem CI-Push. Das ist „Pilot zu Produktion" – feinere Policy-Stufen und Audit-Export –
Kapitel für Kapitel in der OpenClaw Komplettanleitung
(erweiterte Berechtigungs-YAML, GitHub-Actions-Verdrahtung und 90-Tage-Audit-Aufbewahrung).
Falls noch kein Cloud-Mac vorhanden: Alternativen haben jeweils Trade-offs – ein lokales Laptop mit 24/7-Agents verbrennt Strom und hat keine feste Auslands-IP; öffentliche Cloud-macOS-VMs fehlt native OpenClaw-Integration und Betriebs-Audit auf Systemaufruf-Ebene; Büro-Mac-minis kaufen bedeutet Hardware-Abschreibung und Ops-Personal. PixVPS bietet dedizierte physische Mac mini M4 (16 GB Unified Memory, 38 TOPS, 1 Gbps dedizierte Bandbreite), OpenClaw in jeder Standardinstanz integriert, Bereitstellung in 1–5 Minuten, ab $21.1/Tag – tageweise für Agent-Experimente mieten, bei stabilem Bedarf auf $105.7/Monat wechseln, flexibler als Hardware-Kauf bei unsicherer Nachfrage.
Empfohlener Pfad: heute Read-only-Sandbox laufen lassen → morgen Policy-Vorlage für Ihren Aufgabentyp kopieren (Build / Doc-Fetch / Ops-Patrol – Vergleichstabelle in der Komplettanleitung) →
Woche drei YAML in Git committen und openclaw audit export in CI erzwingen.
Für parallele Build-Agents: Ein M4 mit 16 GB betreibt in unseren Tests zuverlässig zwei Sandboxes mit DerivedData;
für mehr Parallelität Thunderbolt-5-Clustering für einen 80-Gbps-Multi-Maschinen-Pool hinzufügen.
Bei Fragen zur Einrichtung erreichen Sie uns unter [email protected] – Antwort innerhalb einer Stunde, 7×24.
Ihrem Agent in fünf Minuten einen Cloud-Mac mit OpenClaw geben
PixVPS Mac mini M4 dedizierte Nodes mit integrierter OpenClaw-Sandbox: Isolierung auf Betriebs-Ebene, Zero-Trust-Zugriff, nachvollziehbare Audit-Logs, 16 GB Unified Memory für Agent und Xcode parallel – ab $21.1/Tag an fünf globalen Nodes.