Der OpenClaw-Hintergrunddienst lässt sich nicht beenden? Hier ist die echte Lösung

Wenn sich das OpenClaw-Gateway nicht herunterfahren lässt, spüren Sie das sofort: Die Lüfter drehen weiter, Ports bleiben gebunden und der Agent führt weiterhin Automatisierungen aus, selbst nachdem Sie die App „beendet“ haben. Da das Gateway als Hintergrunddienst läuft, wird der Prozess durch das Schließen der Benutzeroberfläche oder das Abmelden von Ihrer Desktop-Sitzung selten beendet. Wenn Sie ihn nicht sauber herunterfahren, kommt es zu doppelten Instanzen, nicht einbindbaren Laufwerken oder verbleibenden Webhooks. Diese Anleitung erklärt, was wirklich passiert und wie Sie den Dienst auf jedem Betriebssystem sicher beenden können.

TL;DR

1. OpenClaw installiert sich als persistenter Dienst (systemd --user, launchctl oder OpenClawGateway unter Windows), daher bewirkt das Beenden der Benutzeroberfläche nichts.
2. Beenden Sie ihn zuerst auf dem offiziellen Weg (openclaw gateway stop, openclaw gateway autostart disable). Wenn er immer wieder neu startet, entfernen Sie den Launch Agent oder die Dienstdefinition.
3. Überprüfen Sie dies vorher und nachher mit systemctl --user status openclaw-gateway, launchctl list ai.openclaw.gateway oder Get-Service OpenClawGateway.
4. Sobald er beendet ist, löschen Sie verbleibende Sockets/Protokolle und erstellen Sie den Autostart nur dann neu, wenn Sie ihn wirklich benötigen.

Verstehen, wie der Dienst installiert wird

OpenClaw stellt ein Hintergrund-Gateway bereit, wenn Sie openclaw gateway start zum ersten Mal ausführen. Das Installationsprogramm legt Folgendes ab:

1. Linux: eine systemd-Unit auf Benutzerebene ~/.config/systemd/user/openclaw-gateway.service sowie eine Aktivierung des Linger-Modus, damit sie auch nach dem Abmelden ausgeführt wird.
2. macOS: eine LaunchAgent-Plist ~/Library/LaunchAgents/ai.openclaw.gateway.plist, die das Gateway neu startet.
3. Windows: ein Eintrag im Service Control Manager namens OpenClawGateway sowie eine geplante Aufgabe, die ihn wieder aktiviert, wenn Sie den Autostart nur in der Benutzeroberfläche deaktivieren.
4. Wenn Sie wissen, welcher Supervisor den Prozess besitzt, wissen Sie auch, welcher Befehl ihn tatsächlich beendet.

Schnelle Überprüfung, bevor Sie den Stecker ziehen

Aktive Sitzungen prüfen: Führen Sie openclaw status aus, um zu sehen, ob Jobs gerade ausgeführt werden; ein Abbruch kann Workflows verwaist zurücklassen.

Versuch eines sauberen Stopps: openclaw gateway stop --timeout 30. Wenn der Befehl erfolgreich ist, sind Sie fertig.

Neustartlogik bestätigen: openclaw gateway autostart status zeigt an, ob ein Watcher ihn neu starten wird.

Protokolle erfassen: Verfolgen Sie ~/.openclaw/logs/gateway.log (Linux/macOS) oder das Windows-Ereignisprotokoll, damit Sie die Ursache nach der Behebung bestätigen können.

Linux: Den systemd-Benutzerdienst anhalten

systemctl --user stop openclaw-gateway.service

systemctl --user disable openclaw-gateway.service

systemctl --user daemon-reload

loginctl disable-linger $USER (optional), um den automatischen Start nach dem Abmelden zu verhindern.

Überprüfen Sie mit systemctl --user status openclaw-gateway – es sollte inactive (dead) angezeigt werden.

Wenn ein unerwünschter Prozess verbleibt, führen Sie pkill -f openclaw-gateway aus und löschen Sie die Unit-Datei, bevor Sie sie wieder aktivieren.

macOS: Den LaunchAgent entladen

launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist

launchctl remove ai.openclaw.gateway 2>/dev/null

Löschen Sie die plist, wenn Sie keinen Autostart wünschen: rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist

Beenden Sie alle verbleibenden Prozesse: pkill -f openclaw-gateway

Starten Sie neu oder führen Sie openclaw gateway start erst aus, nachdem Sie mit ps aux | grep openclaw bestätigt haben, dass die alte PID verschwunden ist.

Windows: Den SCM-Eintrag und die geplante Aufgabe beenden

Öffnen Sie PowerShell als Administrator und führen Sie Stop-Service -Name OpenClawGateway -Force aus

Set-Service -Name OpenClawGateway -StartupType Disabled

Löschen Sie die geplante Aufgabe, die ihn neu startet: Unregister-ScheduledTask -TaskName "OpenClaw Autostart" -Confirm:$false

Wenn die PID bestehen bleibt, führen Sie Stop-Process -Name openclaw -Force aus

Bestätigen Sie mit Get-Service OpenClawGateway – der Status sollte Stopped sein.

Sie können auch die Microsoft-Dokumentation lesen.

Wenn sich der Dienst immer wieder selbst neu startet

Die CLI von OpenClaw kann Autostart-Helfer bei jeder Aktualisierung oder Authentifizierung neu erstellen. Führen Sie diese Befehle aus, um die Erwartungen zurückzusetzen:

1. openclaw gateway autostart disable (deaktiviert von der CLI verwaltete Neustarter)
2. openclaw gateway doctor (meldet verwaiste Units)
3. Veraltete Sockets löschen (Linux/macOS): rm -f ~/.openclaw/run/gateway.sock
4. Wenn der Dienst sofort neu startet, ruft etwas anderes (z. B. ein Überwachungsskript oder ein MDM-Profil) openclaw gateway start auf. Durchsuchen Sie Ihre Crontab, ~/.config/openclaw/autostart.sh und Enterprise-Management-Tools.

Das Herunterfahren überprüfen

Nachdem Sie die obigen Schritte ausgeführt haben:

1. Prozesse: ps, der Task-Manager oder die Aktivitätsanzeige sollten keine openclaw-Einträge anzeigen.
2. Ports: lsof -i :11434 (ersetzen Sie dies durch Ihren OpenClaw-Port) sollte nichts zurückgeben.
3. Protokolle: Die letzten Zeilen des Gateway-Protokolls sollten Stopping gateway... enthalten und danach keine neuen Einträge mehr aufweisen.
4. Ressourcenmonitore: Die CPU- und RAM-Auslastung sollte auf den Ausgangswert zurückfallen.

Wiederauftreten verhindern

1. Aktivieren Sie den Autostart nur auf Maschinen, die wirklich eine 24/7-Abdeckung benötigen.
2. Dokumentieren Sie, welche Benutzer und Hosts OpenClaw ausführen; doppelte Installationen treten häufig auf, wenn Teams Anmeldeinformationen teilen.
3. Planen Sie vierteljährliche Audits: Listen Sie alle systemd-Benutzereinheiten, LaunchAgents und Windows-Dienste mit dem Namen *openclaw* auf, um Abweichungen zu erkennen.
4. Halten Sie das CLI auf dem neuesten Stand. Ältere Builds ignorieren manchmal stop-Anfragen, weil die Supervisor-Binärdatei nicht mit der Gateway-Version übereinstimmt.

Fazit

Ein außer Kontrolle geratener OpenClaw-Hintergrunddienst ist fast immer ein Supervisor-Problem: Das Betriebssystem tut genau das, was Sie von ihm verlangt haben – es hält das Gateway am Leben. Sobald Sie die Unit, die plist-Datei oder den Windows-Dienst entfernen und die Autostart-Flags überprüfen, bleibt der Prozess beendet. Behandeln Sie das Gateway wie jeden anderen Daemon: Beenden Sie es sauber, deaktivieren Sie den Watcher, bestätigen Sie, dass es beendet ist, und aktivieren Sie es erst wieder, wenn Sie bereit sind. Sie können auch OpenClaw deinstallieren, wie in unserer Anleitung beschrieben.

FAQ

Warum startet OpenClaw sofort wieder, nachdem ich es beendet habe?

Weil der Autostart-Watcher (systemd lingering, LaunchAgents oder eine geplante Aufgabe) noch aktiviert ist. Deaktivieren Sie den Watcher, bevor Sie den Dienst beenden.

Kann ich den Prozess einfach über die Aktivitätsanzeige oder den Task-Manager beenden?

Das können Sie, aber er wird wahrscheinlich neu starten, es sei denn, Sie deaktivieren die Dienstdefinition. Befolgen Sie die oben genannten betriebssystemspezifischen Schritte, um zuerst den Supervisor-Eintrag zu entfernen.

Ist es sicher, die LaunchAgent- oder systemd-Unit zu löschen?

Ja, solange Sie planen, sie später neu zu installieren oder wieder zu aktivieren. Das CLI kann mit openclaw gateway autostart enable neue Units generieren, sobald Sie den Hintergrundmodus wieder benötigen.