> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## Mechanisme

* 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.

## Foutinterface

* 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>: …")`.

## Operationele opmerkingen

* 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.

## Gerelateerd

* [Meerdere Gateways](/nl/gateway/multiple-gateways) — meerdere instanties draaien met unieke poorten
* [Probleemoplossing](/nl/gateway/troubleshooting) — `EADDRINUSE` en poortconflicten diagnosticeren