Gateway

Gateway-vergrendeling

Waarom

Zorg ervoor dat er slechts één Gateway-instantie per basispoort op dezelfde host draait; extra Gateways moeten geïsoleerde profielen en unieke poorten gebruiken.
Overleef crashes/SIGKILL zonder verouderde lockbestanden achter te laten.
Faalt snel met een duidelijke fout wanneer de controlepoort al bezet is.

De Gateway verkrijgt eerst een lockbestand per configuratie onder de statuslockmap en controleert de geconfigureerde poort op een bestaande listener.
Als de geregistreerde lockeigenaar verdwenen is, de poort vrij is of de lock verouderd is, claimt het opstarten de lock opnieuw en gaat het verder.
De Gateway bindt vervolgens de HTTP/WebSocket-listener (standaard ws://127.0.0.1:18789) met een exclusieve TCP-listener.
Als het binden mislukt met EADDRINUSE, geeft het opstarten GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:<port>").
Bij het afsluiten sluit de Gateway de HTTP/WebSocket-server en verwijdert hij het lockbestand.

Als een ander proces de poort bezet houdt, geeft het opstarten GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:<port>").
Andere bindfouten komen naar voren als GatewayLockError("failed to bind gateway socket on ws://127.0.0.1:<port>: …").

Als de poort bezet is door een ander proces, is de fout hetzelfde; maak de poort vrij of kies een andere met openclaw gateway --port <port>.
Onder een servicemanager laat een nieuw Gateway-proces dat een bestaande gezonde /healthz-responder ziet, dat proces de controle behouden. Op systemd sluit de dubbele starter af met code 78, zodat de standaard RestartPreventExitStatus=78 voorkomt dat Restart=always blijft herhalen bij een lock- of EADDRINUSE-conflict. Als het bestaande proces nooit gezond wordt, zijn nieuwe pogingen begrensd en mislukt het opstarten met een duidelijke lockfout in plaats van eindeloos te blijven herhalen.
De macOS-app behoudt nog steeds zijn eigen lichte PID-bewaking voordat de Gateway wordt gestart; de runtime-lock wordt afgedwongen door het lockbestand plus de HTTP/WebSocket-binding.