Instanz-Monitoring und Zustandsprüfung

Übersicht

Jede ClawHosters-Instanz verfügt über ein integriertes Zustandsmonitoring. Das Instanz-Dashboard zeigt den aktuellen Status deiner Instanz, die Ressourcenauslastung und den Container-Zustand an. Diese Seite erklärt, wie Health Checks funktionieren, was die Statusindikatoren bedeuten und was du tun kannst, wenn etwas schiefläuft.

Instanz-Status

Das Instanz-Dashboard zeigt den aktuellen Status deiner Instanz mit einem farbcodierten Indikator:

Eine laufende Instanz mit grünem Indikator bedeutet, dass der Container aktiv ist und auf Health Checks antwortet.

Docker Health Checks

Jede Instanz läuft in einem Docker-Container mit einem automatisch konfigurierten Health Check:

Docker markiert den Container als healthy, wenn der Prüfbefehl erfolgreich ist, oder als unhealthy nach 3 aufeinanderfolgenden Fehlschlägen. Die 60-Sekunden-Startperiode gibt dem OpenClaw-Gateway Zeit zur Initialisierung, bevor die Health Checks beginnen.

Ressourcenauslastung

Das Instanz-Dashboard zeigt die Ressourcenauslastung deines VPS:

Diese Metriken werden regelmäßig aktualisiert. Wenn eine Metrik konstant hohe Werte erreicht, kann deine Arbeitslast von einem höheren Paket profitieren.

Ressourcenlimits nach Paket

Das Arbeitsspeicher-Limit wird auf Docker-Container-Ebene durchgesetzt. Wenn deine Instanz dieses Limit überschreitet, kann Docker den Container-Prozess beenden (OOM-Kill).

Zustand per SSH prüfen

Wenn du SSH-Zugang aktiviert hast, kannst du deine Instanz direkt inspizieren:

# Prüfen, ob der Container läuft
docker ps

# Container-Health-Status anzeigen
docker inspect --format='{{.State.Health.Status}}' openclaw-<instanz_id>

# Letzte Health-Check-Ergebnisse anzeigen
docker inspect --format='{{json .State.Health}}' openclaw-<instanz_id> | python3 -m json.tool

# Ressourcenverbrauch prüfen
docker stats --no-stream

# Speicherplatz auf dem VPS prüfen
df -h

# Arbeitsspeicher-Nutzung prüfen
free -h

Ersetze <instanz_id> durch deine Instanz-ID, die im Dashboard angezeigt wird.

Häufige Zustandsprobleme

Container-Neustart-Schleifen

Der Container stoppt und startet ständig neu. Mögliche Ursachen:

• Der OpenClaw-Prozess stürzt beim Start wegen eines Konfigurationsproblems ab
• Unzureichender Arbeitsspeicher verursacht einen OOM-Kill, und Docker startet den Container neu

Prüfe die Container-Logs auf Fehlermeldungen:

docker logs openclaw-<instanz_id> --tail 50

Out-of-Memory (OOM) Kills

Docker beendet den Container, wenn er sein Arbeitsspeicher-Limit überschreitet. Anzeichen für OOM:

• Container startet unerwartet neu
• docker inspect zeigt OOMKilled: true

Wenn das häufig passiert, erwäge ein Upgrade auf ein höheres Paket mit mehr Arbeitsspeicher.

Speicherplatz voll

Wenn dem VPS der Speicherplatz ausgeht, kann der Container möglicherweise keine Logs oder Daten mehr schreiben. Prüfe mit:

df -h

Wenn die Speichernutzung fast am Limit ist, suche nach großen Log-Dateien oder angesammelten Daten. Docker-Log-Rotation ist konfiguriert (maximal 50 MB, 3 Dateien), aber Anwendungsdaten innerhalb des Containers können trotzdem wachsen.

Health-Check-Fehlschläge

Der Health Check ruft http://localhost:18789/ innerhalb des Containers auf. Wenn das fehlschlägt:

• Das OpenClaw-Gateway startet möglicherweise noch (warte 60 Sekunden nach einem Neustart)
• Der Gateway-Prozess ist möglicherweise abgestürzt (prüfe die Container-Logs)
• Port-Binding-Probleme innerhalb des Containers

Was tun, wenn deine Instanz ungesund ist

Schritt 1: Dashboard prüfen

Öffne dein Instanz-Dashboard. Der Statusindikator und eventuelle Fehlermeldungen geben den ersten Hinweis.

Schritt 2: Instanz neu starten

Die meisten vorübergehenden Probleme lassen sich durch einen Neustart beheben:

1. Gehe zum Instanz-Dashboard
2. Klicke auf Stoppen
3. Warte einige Sekunden
4. Klicke auf Starten

Die Instanz wird neu provisioniert und der Container startet frisch.

Schritt 3: Instanz neu aufbauen

Wenn ein Neustart nicht hilft, baue die Instanz über das Dashboard neu auf. Dies erstellt einen frischen Container mit deiner bestehenden Konfiguration. Manuelle Änderungen über SSH gehen dabei verloren.

Schritt 4: Logs prüfen (SSH)

Wenn du SSH-Zugang hast, inspiziere die Container-Logs:

docker logs openclaw-<instanz_id> --tail 100

Suche nach Fehlermeldungen, Stack Traces oder wiederkehrenden Absturzmustern.

Schritt 5: Support kontaktieren

Wenn das Problem weiterhin besteht und du die Ursache nicht identifizieren kannst, kontaktiere den Support über das ClawHosters-Dashboard. Gib dabei an:

• Deine Instanz-ID
• Den im Dashboard angezeigten Status
• Wann das Problem begonnen hat
• Welche Änderungen du kürzlich vorgenommen hast

Support ist verfügbar für Instanzen ohne aktivierten SSH-Zugang. Instanzen mit SSH-Zugang sind auf Abrechnungs- und Konto-Support beschränkt.

Verwandte Dokumentation

• Instanz-Übersicht — Instanz-Status, Lebenszyklus und Pakete
• Instanz-Einstellungen und Konfiguration — LLM, Messaging und Web-Zugangs-Einstellungen
• Instanzen starten und stoppen — Energieverwaltung und Abrechnungsauswirkungen
• SSH-Zugang zu deiner Instanz — Direkter Serverzugang für fortgeschrittene Nutzer
• Häufige Probleme beheben — Lösungen für häufige Probleme