OpenClaw Daemon verwalten: Gateway-Dienste steuern

Es ist oft nervig, wenn man sich durch verschiedene CLI-Befehle wühlen muss, nur um einen Hintergrunddienst zu verwalten. Besonders wenn sich Tools weiterentwickeln, fragst du dich oft, welcher Befehl eigentlich der aktuelle Standard ist und was nur noch aus Kompatibilitätsgründen existiert.

openclaw daemon ist ein Legacy-Alias für die Befehle zur Verwaltung des Gateway-Service. Er entspricht exakt dem Funktionsumfang der openclaw gateway ... Service-Befehle.

Nutzung

openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall

Subbefehle

• status: Zeigt den Installationsstatus des Service an und prüft den Gateway-Zustand.
• install: Installiert den Service (launchd/systemd/schtasks).
• uninstall: Entfernt den Service.
• start: Startet den Service.
• stop: Stoppt den Service.
• restart: Startet den Service neu.

Gemeinsame Optionen

• status: --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
• install: --port, --runtime <node|bun>, --token, --force, --json
• Lifecycle (uninstall|start|stop|restart): --json

Hinweise:

• status löst konfigurierte SecretRefs für die Authentifizierung auf, um den Probe-Status zu prüfen.
• Falls eine benötigte SecretRef in diesem Pfad nicht aufgelöst werden kann, gibt daemon status --json eine rpc.authWarning aus, wenn die Verbindung oder Authentifizierung fehlschlägt. Gib den --token oder das --password explizit an oder löse die Secret-Quelle vorher auf.
• Wenn der Probe-Check erfolgreich ist, werden Warnungen zu nicht aufgelösten SecretRefs unterdrückt, um falsche Fehlermeldungen zu vermeiden.
• Bei systemd-Installationen unter Linux prüfen die Token-Drift-Checks sowohl Environment= als auch EnvironmentFile= Quellen der Unit.
• Drift-Checks lösen gateway.auth.token SecretRefs über die zusammengeführte Runtime-Umgebung auf (zuerst Service-Befehl-Umgebung, dann Prozess-Umgebung als Fallback).
• Falls die Token-Authentifizierung nicht aktiv ist (expliziter gateway.auth.mode auf password, none oder trusted-proxy, oder wenn der Modus nicht gesetzt ist und ein Passwort Vorrang hat), überspringen die Drift-Checks die Token-Auflösung.
• Wenn die Token-Authentifizierung einen Token erfordert und gateway.auth.token über eine SecretRef verwaltet wird, validiert install, dass die SecretRef auflösbar ist. Der aufgelöste Token wird jedoch nicht dauerhaft in den Metadaten der Service-Umgebung gespeichert.
• Wenn die Token-Authentifizierung einen Token benötigt und die konfigurierte SecretRef nicht aufgelöst werden kann, schlägt die Installation fehl (fail closed).
• Falls sowohl gateway.auth.token als auch gateway.auth.password konfiguriert sind und gateway.auth.mode nicht gesetzt ist, wird die Installation blockiert, bis du den Modus explizit festlegst.

Empfehlung

Nutze openclaw gateway für die aktuelle Dokumentation und Beispiele.

AI Setup Assistant

Nächste Schritte

• Gateway CLI Referenz
• Service Konfiguration