Voraussetzungen und Umgebung
Bevor Sie OpenClaw per Docker auf einem Remote-Mac deployen, müssen Mac-Umgebung, Ressourcen und Docker erfüllt sein. Die folgende Tabelle fasst die Mindestanforderungen und Empfehlungen zusammen.
| Kriterium | Mindestanforderung | Empfohlen (Stabilität) |
|---|---|---|
| Betriebssystem | macOS 12+ (Monterey) | macOS 14+ (Sonoma), Apple Silicon bevorzugt |
| RAM | 8 GB | 16 GB oder mehr für CI + mehrere Container |
| Festplatte | 20 GB freier Speicher | 50 GB+ für Images, Cache und Logs |
| Docker | Docker Desktop oder Docker Engine | Aktuelle stabile Version, Daemon läuft |
| Netzwerk | Zugriff auf Repo und ggf. Modell-Gateway | Stabile Verbindung, niedrige Latenz für CI-Calls |
Prüfen Sie mit docker info und docker run hello-world, ob Docker korrekt läuft. Auf Remote-Macs (z. B. MacPull Mac Mini M4) sind diese Voraussetzungen typischerweise erfüllt; Sie vermeiden lokale Ressourcenengpässe und haben eine dauerhaft verfügbare CI-Node.
Docker-Deploymentschritte
Reproduzierbare Schritte von Clone bis Verifikation:
- Schritt 1 – Repository klonen:
git clone <openclaw-repo-url>und in das Verzeichnis wechseln. - Schritt 2 – docker-setup ausführen: Falls ein
docker-setup-Skript oder eine Anleitung vorhanden ist, ausführen (z. B../docker-setupoderdocker compose build). Damit werden Images gebaut und Abhängigkeiten bereitgestellt. - Schritt 3 – .env konfigurieren: Datei
.envim Projektroot anlegen bzw. anpassen. Typische Variablen: API-Keys, Gateway-URLs, Log-Level. Niemals .env in Version Control committen. - Schritt 4 – openclaw.json anpassen: Konfiguration für Modelle, Endpoints und ggf. Retry-Parameter in
openclaw.jsonsetzen (siehe nächster Abschnitt). - Schritt 5 – Start und Verifikation: Container starten (
docker compose up -doder laut Dokumentation). Health-Check oderopenclaw status/openclaw doctorausführen und Ausgabe prüfen.
Gateway- und Modellkonfiguration
In openclaw.json legen Sie Gateway-URLs, Modell-IDs und optionale Parameter fest. Typische Felder: Base-URL des AI-Gateways, API-Key-Referenz (z. B. aus .env), Modellname, Timeouts und Retry-Einstellungen. Dokumentation des OpenClaw-Projekts beachten; bei Verwendung eines Kilo- oder anderen Gateways die offizielle Konfigurationsreferenz nutzen. Nach Änderungen Container neu starten und mit einem kleinen Aufruf testen.
OpenClaw in der CI aufrufen
CI-Nutzer können OpenClaw nach dem Deployment entweder über GitHub Actions oder über Skripte auf dem Remote-Mac aufrufen.
GitHub Actions: Job auf einem self-hosted Runner ausführen, der auf dem gleichen Remote-Mac (oder einem erreichbaren Host) läuft. Im Job: SSH zum Mac oder direkter Aufruf von openclaw in der Umgebung, in der Docker/OpenClaw installiert ist. Alternativ per curl einen HTTP-Endpunkt von OpenClaw ansprechen, falls die Instanz einen API-Server bereitstellt.
Skript-Aufruf: Auf dem Remote-Mac ein Cron-Job oder ein Pipeline-Skript (z. B. Shell), das openclaw <Befehl> oder einen HTTP-Request ausführt. Secrets (API-Keys, URLs) aus Umgebungsvariablen oder einem Secret-Manager lesen, nicht im Skript hardcoden.
Häufige Fehler und Fehlersuche
Typische Probleme und kurze Gegenmaßnahmen:
| Symptom | Ursache | Maßnahme |
|---|---|---|
| Container startet nicht / Exit Code | Fehlende .env, falsche Pfade oder Ports | docker compose logs prüfen; .env und openclaw.json auf Vollständigkeit und Syntax prüfen. |
| Gateway/Modell nicht erreichbar | Netzwerk, Firewall oder falsche URL in openclaw.json | URL und API-Key testen (z. B. curl); von innerhalb des Containers Netzwerkzugriff prüfen. |
| CI-Job schlägt mit Timeout fehl | Remote-Mac überlastet oder OpenClaw antwortet langsam | Ressourcen (RAM/CPU) auf dem Mac prüfen; OpenClaw-Logs und Retry-/Timeout-Werte in openclaw.json anpassen. |
- Voraussetzungen: Mac mit ausreichend RAM (empf. 16 GB), Festplatte (empf. 50 GB+), Docker installiert und lauffähig.
- Deployment: Clone → docker-setup / compose build → .env und openclaw.json konfigurieren → starten → status/doctor zur Verifikation.
- CI: GitHub Actions mit self-hosted Runner auf dem Mac oder Skript-Aufruf auf dem Remote-Mac; Secrets nicht im Code speichern.
Fazit
OpenClaw per Docker auf einem Remote-Mac zu deployen und in CI zu integrieren gelingt mit klaren Voraussetzungen (Mac-Umgebung, RAM/Festplatte, Docker), reproduzierbaren Schritten (Clone, docker-setup, .env, openclaw.json, Start, Verifikation) und der Einbindung in GitHub Actions oder Skripte. Gateway- und Modellkonfiguration in openclaw.json sowie die Behebung typischer Fehler (Container-Logs, Netzwerk, Timeouts) runden das Setup ab. Für eine stabile und dauerhaft verfügbare Umgebung empfehlen wir einen gemieteten Remote-Mac (z. B. Mac Mini M4 bei MacPull): Keine lokale Hardware-Last, feste Ressourcen und ideal für CI und OpenClaw. Preise und Pakete finden Sie auf der Startseite und unter Preise, Bestellung unter Jetzt kaufen; weitere Anleitungen im Technik-Blog.
Mac Mini M4 mieten – OpenClaw stabil betreiben
Docker und CI auf einem dedizierten Remote-Mac: Keine lokale Last, feste Ressourcen. Preise ansehen, Paket wählen, in Minuten starten.