Docker-Konfiguration

Wie Docker genutzt wird

Jede ClawHosters-Instanz führt OpenClaw in einem Docker-Container auf einem dedizierten VPS aus. Docker bietet Isolation, Ressourcenlimits und einheitliche Deployments über alle Instanzen hinweg.

Du musst für den normalen Gebrauch nicht direkt mit Docker interagieren. ClawHosters verwaltet den Container-Lebenszyklus automatisch. Diese Referenz ist für Nutzer, die sich per SSH für erweiterte Konfiguration verbinden.

Container-Setup

Der OpenClaw-Container wird durch eine docker-compose.yml-Datei definiert, die ClawHosters während des Deployments generiert.

Docker-Image

ClawHosters nutzt ein eigenes OpenClaw-Image, das SSH-Unterstützung für Remote-Zugriff mitbringt. Das Image wird während der Snapshot-Erstellung vorgeladen, sodass das Deployment schnell abläuft.

Ports

Das Gateway ist über die Domain deiner Instanz erreichbar. SSH-Zugang ist über Port 2222 verfügbar.

Container-Startbefehl

gateway --allow-unconfigured --bind lan

Das --allow-unconfigured-Flag lässt das Gateway auch ohne konfiguriertes LLM starten. Das --bind lan-Flag bindet an die lokale Netzwerkschnittstelle.

Ressourcenlimits

Docker erzwingt Speicherlimits basierend auf deinem Tier, um stabile Performance sicherzustellen. Jeder Tier hat passende Speicherzuteilung, die für dessen Workload optimiert ist.

Wenn der Container das Speicherlimit überschreitet, startet Docker ihn automatisch neu, um die Dienstverfügbarkeit zu erhalten.

Volumes

Der Container nutzt Docker-Volumes und Bind-Mounts für persistente Daten:

Das benannte Volume openclaw_data speichert Anwendungsdaten unter /app/data. Das Konfigurationsverzeichnis unter /root/.openclaw ist ein separater Bind-Mount von ./dotopenclaw auf dem Host (unter /opt/openclaw/dotopenclaw). Diese Trennung ermöglicht es, Konfigurationsdateien unabhängig von den Anwendungsdaten zu aktualisieren.

Daten in diesen Volumes überleben Container-Neustarts und Reboots. Ein Rebuild ersetzt den Container, bewahrt aber die Host-Level-Daten.

Health Check

Docker überwacht automatisch die Gesundheit deiner Instanz. Das Gateway braucht bis zu 60 Sekunden zum Starten. Danach sorgen regelmäßige Health-Checks dafür, dass deine Instanz online bleibt. Wenn Health-Checks wiederholt fehlschlagen, versucht Docker automatisch, den Container neu zu starten.

Container-Berechtigungen

Der Container läuft als root (user: "0"). Das ist beabsichtigt. OpenClaw braucht Root-Zugriff für:

• Paketinstallation zur Laufzeit (Skills können zusätzliche Tools erfordern)
• Zugriff auf Systemressourcen für Browser-Automatisierung
• Dateiverwaltung im gesamten Container-Dateisystem

Docker-Sicherheit

Der Docker-Daemon des Hosts ist mit Sicherheitshärtung und Ressourcenverwaltung konfiguriert. Container sind isoliert, Privilegien-Eskalation wird verhindert, und Logging wird verwaltet, um Speicherplatzprobleme zu vermeiden.

Nützliche Docker-Befehle

Wenn du dich per SSH mit deiner Instanz verbindest, sind diese Befehle nützlich:

Container-Status prüfen

docker ps

Container-Logs anzeigen

# Letzte 100 Zeilen
docker logs --tail 100 openclaw-<id>

# Logs in Echtzeit verfolgen
docker logs -f openclaw-<id>

Container neustarten

cd /opt/openclaw && docker compose restart

Befehle im Container ausführen

# Interaktive Shell
docker exec -it openclaw-<id> bash

# Einzelnen Befehl ausführen
docker exec openclaw-<id> node --version

Ressourcennutzung prüfen

docker stats openclaw-<id> --no-stream

Das zeigt aktuelle CPU-, Speicher- und Netzwerknutzung.

Was du vermeiden solltest

• Führe nicht docker compose down aus. Das stoppt und entfernt den Container. Nutze stattdessen restart.
• Ziehe kein neues Image manuell. ClawHosters verwaltet Image-Updates über Snapshots.
• Ändere nicht docker-compose.yml. ClawHosters überschreibt sie beim Redeployment. Eigene Änderungen gehen verloren.
• Ändere nicht das Speicherlimit. Es ist basierend auf deinem Tier gesetzt. Eine Erhöhung über die VPS-Kapazität hinaus lässt den Host abstürzen.

Verwandte Dokumentation

• Umgebungsvariablen: An den Container übergebene Variablen
• Ressourcenlimits: CPU, RAM, Speicher nach Tier
• SSH-Zugang: Verbindung zu deiner Instanz
• Instanz neu aufsetzen: Factory-Reset