Häufige Probleme beheben

Bevor du anfängst

Die meisten Probleme lösen sich innerhalb weniger Minuten von selbst. Die Provisionierung dauert etwa 60 Sekunden, und das Deployment kommt nochmal mit 30-60 Sekunden dazu. Wenn deine Instanz weniger als zwei Minuten bei „Provisionierung" oder „Deployment" hängt, gib ihr etwas Zeit.

Falls danach immer noch etwas nicht stimmt, schau in die folgenden Abschnitte.

Instanz hängt bei „Provisionierung"

Deine Instanz zeigt „Provisionierung" an, aber nichts passiert.

Was passiert: Ein neuer Hetzner-Cloud-VPS wird für deine Instanz erstellt. Das dauert normalerweise 30-60 Sekunden.

Was du prüfen kannst:

• Warte mindestens zwei Minuten, bevor du etwas unternimmst. Das System pollt automatisch.
• Aktualisiere die Dashboard-Seite. Der Status wird per Live-Polling aktualisiert, aber ein manuelles Neuladen kann helfen.
• Wenn die Provisionierung länger als fünf Minuten dauert, ist möglicherweise auf Infrastrukturseite etwas schiefgelaufen. Nutze den „Erneut versuchen"-Button im Instanz-Dashboard, falls verfügbar.

Wenn der erneute Versuch nicht funktioniert: Kontaktiere den Support über das Dashboard. Gib deinen Instanznamen und die ungefähre Uhrzeit an, zu der du die Provisionierung gestartet hast.

Instanz zeigt „Deployment fehlgeschlagen"

Das Deployment wurde abgeschlossen, aber die Instanz konnte nicht ordnungsgemäß starten.

Was passiert: Das System hat den Server erstellt, deine Konfiguration hochgeladen und den Docker-Container gestartet, aber der Health-Check war nicht erfolgreich. Das System versucht es automatisch bis zu fünf Minuten lang erneut, bevor das Deployment als fehlgeschlagen markiert wird.

Häufige Ursachen:

• Vorübergehendes Infrastrukturproblem beim Container-Start
• Konfigurationskonflikt aus einer vorherigen Sitzung

Was du tun kannst:

1. Öffne das Instanz-Dashboard
2. Klicke auf „Deployment erneut versuchen"
3. Warte auf das neue Deployment (etwa 60 Sekunden)

Wenn der erneute Versuch wieder fehlschlägt, kontaktiere den Support. Die Server-Logs enthalten möglicherweise weitere Details.

Instanz zeigt „Konfiguration ausstehend"

Deine Instanz läuft, ist aber als „Konfiguration ausstehend" markiert.

Was passiert: Die Server-Infrastruktur ist bereit und der Docker-Container läuft, aber es wurde noch kein LLM-API-Schlüssel konfiguriert. Ohne API-Schlüssel kann der KI-Assistent keine Nachrichten verarbeiten.

Was du tun kannst:

1. Öffne das Instanz-Dashboard
2. Klicke auf „LLM konfigurieren" oder gehe zum LLM-Einstellungsbereich
3. Gib deinen API-Schlüssel für den gewünschten Anbieter ein (Anthropic, OpenAI, OpenRouter, Google oder DeepSeek)
4. Speichere die Konfiguration

Die Instanz wechselt zu „Läuft", sobald ein gültiger API-Schlüssel gespeichert wurde.

Instanz pausiert (niedriges Guthaben)

Deine Instanz wurde gestoppt und zeigt „Pausiert" an.

Was passiert: Dein Claws-Guthaben ist nach der täglichen Abrechnung (um Mitternacht GMT) unter null gefallen. Das System hat automatisch:

1. Einen Snapshot deiner Instanz erstellt (alle Daten und Konfigurationen werden gesichert)
2. Den Hetzner-Server heruntergefahren (stoppt alle Kosten)

Deine Daten sind im Snapshot sicher. Es gehen keine Daten verloren.

Was du tun kannst:

1. Lade mehr Claws auf dein Konto (Dashboard → Guthaben aufladen)
2. Gehe zurück zum Instanz-Dashboard
3. Klicke auf „Fortsetzen"
4. Das System stellt deinen Snapshot auf einem neuen Server wieder her (dauert etwa 60 Sekunden)

Wichtig: Pausierte Instanzen haben eine 3-tägige Nachfrist. Nach 3 Tagen ohne Wiederaufnahme werden der Snapshot und die Instanzdaten dauerhaft gelöscht. Du erhältst vorher E-Mail-Warnungen.

Tägliche Claws-Kosten nach Paket:

Paket	Tägliche Kosten
Budget	45 Claws
Balanced	75 Claws
Pro	125 Claws

Tipp: Du erhältst Warnungen bei niedrigem Guthaben, wenn dein Kontostand unter 3, 2 und 1 Tag Betriebskosten fällt.

LLM-API-Schlüssel funktioniert nicht

Du hast einen API-Schlüssel eingegeben, aber die Instanz meldet einen Fehler oder Nachrichten werden nicht verarbeitet.

Prüfe das Schlüsselformat:

Anbieter	Erwartetes Format
Anthropic	Beginnt mit sk-ant-
OpenAI	Beginnt mit sk-
OpenRouter	Beginnt mit sk-or-
Google, DeepSeek	Variiert je nach Anbieter — direkt aus dem Anbieter-Dashboard kopieren

Häufige Ursachen:

• Tippfehler im Schlüssel — Kopiere den Schlüssel direkt aus dem Dashboard deines Anbieters. Vermeide manuelles Eintippen.
• Schlüssel widerrufen — Prüfe im Dashboard deines Anbieters, ob der Schlüssel noch aktiv ist.
• Unzureichende Berechtigungen — Manche Anbieter geben Schlüssel mit eingeschränktem Umfang aus. Stelle sicher, dass dein Schlüssel Modellzugriffsrechte hat.
• Kontoproblem — Dein Anbieterkonto hat möglicherweise Abrechnungsprobleme oder Nutzungslimits. Prüfe das Anbieter-Dashboard.

Was du tun kannst:

1. Öffne das Instanz-Dashboard → LLM-Einstellungen
2. Lösche den aktuellen Schlüssel und füge einen neuen aus dem Dashboard deines Anbieters ein
3. Speichere und warte einige Sekunden, bis die Instanz sich neu verbindet

Telegram-Bot antwortet nicht

Du hast einen Telegram-Bot verbunden, aber er antwortet nicht auf Nachrichten.

Prüfe die Grundlagen:

1. Bot-Token gültig? — Öffne Telegram, schreibe @BotFather an und nutze /mybots, um zu prüfen, ob der Bot existiert und das Token übereinstimmt.
2. Token-Format korrekt? — Telegram-Tokens sehen so aus: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz. Prüfe auf fehlende Zeichen.
3. Bot gestartet? — Öffne einen Chat mit deinem Bot in Telegram und sende /start. Manche Bots benötigen diesen ersten Befehl.
4. Instanz läuft? — Prüfe, ob dein Instanzstatus „Läuft" ist (nicht pausiert, gestoppt oder Konfiguration ausstehend).

Probleme mit dem Pairing-Modus:

Wenn deine Instanz den Pairing-Modus verwendet (Standard), antwortet der Bot nur auf genehmigte Benutzer. Der Instanzbesitzer muss sich zuerst mit dem Bot pairen. Prüfe das Instanz-Dashboard für Pairing-Anweisungen.

WhatsApp-Verbindungsprobleme

WhatsApp verbindet sich über einen QR-Code-Pairing-Prozess in der OpenClaw-Weboberfläche, nicht über ein API-Token.

Häufige Probleme:

• QR-Code abgelaufen — QR-Codes laufen nach etwa 60 Sekunden ab. Aktualisiere und scanne schnell erneut.
• Bereits anderweitig verbunden — WhatsApp erlaubt nur ein verknüpftes Gerät pro Telefonnummer für die Weboberfläche. Trenne zuerst die alte Sitzung.
• Instanz läuft nicht — Die Instanz muss im Status „Läuft" sein, bevor du WhatsApp-Pairing starten kannst.

Instanz verbraucht zu viel Speicher

Deine Instanz startet immer wieder neu oder reagiert nicht mehr.

Was passiert: Jede Instanz läuft in einem Docker-Container mit einem Speicherlimit je nach Paket:

Paket	Speicherlimit
Budget	1 GB
Balanced	2 GB
Pro	4 GB

Wenn der Container sein Speicherlimit überschreitet, startet Docker ihn automatisch neu. Das verursacht eine kurze Unterbrechung (wenige Sekunden), aber keinen Datenverlust.

Was du tun kannst:

• Prüfe die Ressourcennutzung im Instanz-Dashboard (CPU-, Speicher- und Festplattenanzeigen)
• Wenn die Speichernutzung durchgehend nahe am Limit liegt, erwäge ein Upgrade auf ein höheres Paket
• Große Dateioperationen oder rechenintensive Aufgaben im KI-Assistenten können den Speicherverbrauch vorübergehend in die Höhe treiben

Monatliche Instanz kann nicht gelöscht werden

Du versuchst, eine Instanz zu löschen, aber der Button ist deaktiviert oder gibt einen Fehler zurück.

Für monatliche Abonnement-Instanzen:

Du musst das Abonnement kündigen, bevor du die Instanz löschen kannst. Aktive Abonnements können nicht gelöscht werden, da sie eine laufende Abrechnungsverpflichtung darstellen.

1. Gehe zum Instanz-Dashboard
2. Kündige zuerst das Abonnement
3. Sobald der Abonnementzeitraum endet oder die Kündigung bestätigt ist, wird die Löschoption verfügbar

Für tägliche Abrechnung:

Instanzen mit täglicher Abrechnung können jederzeit gelöscht werden. Wenn der Lösch-Button nicht funktioniert, prüfe, ob die Instanz sich gerade in einem Übergangsstatus befindet (Provisionierung, Deployment oder Löschung).

Gateway-Weboberfläche lädt nicht

Du versuchst, auf die OpenClaw-Weboberfläche zuzugreifen, aber die Seite lädt nicht.

Prüfe die Grundlagen:

1. Instanz läuft? — Die Instanz muss im Status „Läuft" sein.
2. Richtige URL? — Verwende die Gateway-URL aus dem Instanz-Dashboard. Sie enthält ein Authentifizierungstoken.
3. Token gültig? — Gateway-Tokens werden beim Deployment generiert. Wenn das Token fehlt oder abgelaufen ist, kannst du es im Instanz-Dashboard neu generieren.

Wenn die URL lädt, aber einen Fehler zeigt:

• Der OpenClaw-Container startet möglicherweise gerade neu. Warte 30 Sekunden und versuche es erneut.
• Prüfe die Ressourcennutzung — wenn der Speicher am Limit ist, befindet sich der Container möglicherweise in einer Neustart-Schleife.

Abrechnungsunstimmigkeiten

Dein Claws-Guthaben stimmt nicht mit dem überein, was du erwartet hast.

So funktioniert die tägliche Abrechnung:

• Die Abrechnung erfolgt um Mitternacht GMT
• Die Kosten werden anteilig auf Basis der Betriebsstunden der Instanz an diesem Tag berechnet
• Einrichtungsgebühren werden einmalig bei Erstellung einer neuen Instanz berechnet
• Pausierte Instanzen verursachen keine Kosten

Einrichtungsgebühren nach Paket:

Paket	Einrichtungsgebühr
Budget	150 Claws
Balanced	300 Claws
Pro	450 Claws

Was du prüfen kannst:

1. Dashboard → Abrechnung → Transaktionsverlauf zeigt alle Gebühren mit Zeitstempeln
2. Prüfe, ob du mehrere Instanzen laufen hast (jede verursacht eigene tägliche Kosten)
3. Überprüfe dein Paket — höhere Pakete kosten mehr pro Tag

Brauchst du noch Hilfe?

Wenn nichts davon dein Problem löst:

1. Öffne das ClawHosters-Dashboard
2. Gehe zu Support → Ticket erstellen
3. Gib an: deinen Instanznamen, was du erwartet hast und was tatsächlich passiert ist

Das Support-Team antwortet in der Regel innerhalb von 24 Stunden an Werktagen.

Verwandte Dokumentation

• Instanz-Übersicht — Wie Instanzen funktionieren und ihr Lebenszyklus
• Abrechnungsübersicht — Wie Abrechnung und Zahlungen funktionieren
• Deine Rechnung verstehen — Rechnungsformate, Steuerinformationen und Download-Anleitung
• Sicherheitsübersicht — Infrastruktur und Datenschutz
• Zahlungsmethoden — Zahlungsfehler, Erstattungen und akzeptierte Methoden
• Kündigung und Erstattungen — Abonnements kündigen, tägliche Abrechnung pausieren und Erstattungen
• Das richtige Paket wählen — Paketvergleich und Ressourcenlimits