Run the gateway in the foreground for debugging

gateway & service

// what it does

openclaw gateway run starts the gateway attached to your terminal with logs on stdout — the fastest way to debug startup. --port overrides the default 18789, --verbose adds detail, and --force kills whatever already holds the port. --bind picks loopback (default), lan, tailnet, auto, or custom.

// shell

$ openclaw gateway run
$ openclaw gateway run --port 19001 --verbose
$ openclaw gateway run --force

// gotcha

--force will kill the installed service's listener too. If the service is running, either stop it first or expect run to hold the port until you Ctrl+C. The --dev profile shifts to port 19001, not 18789.

// resources