CLI commands
Gateway
The Gateway is OpenClaw's WebSocket server (channels, nodes, sessions, hooks). All subcommands on the pages listed here live under openclaw gateway ....
openclaw daemon ... is a legacy alias for the service-control subcommands; see openclaw daemon.
Local mDNS + wide-area DNS-SD setup.
How OpenClaw advertises and finds gateways.
Top-level gateway config keys.
Gateway CLI pages
This page is an index. Five pages document openclaw gateway, one per reader
job. Open the page that matches your task.
| Page | Read it when |
|---|---|
| Run the Gateway | You are starting the Gateway, tuning its run options, or reading its shared token. |
| Restart and supervision | You are restarting the Gateway, or an external supervisor owns its lifecycle. |
| Query a running Gateway | You want health, status, stability, diagnostics, or a direct RPC call. |
| Manage the Gateway service | You are installing, starting, stopping, or repairing the native service. |
| Discover gateways (Bonjour) | You are looking for gateways over mDNS or wide-area DNS-SD. |
openclaw gateway install installs and starts the service. --force reinstalls an existing install and may restart a running Gateway. Finish offline configuration and runtime repairs before installation.
Where each section moved
Every anchor from the previous single-page version still resolves here, so an
existing link such as /cli/gateway#manage-the-gateway-service keeps working.
Each entry points at the page that now holds the content.
- Run the Gateway
- Options
- Reveal the configured token
- Restart the Gateway
- Install identity
- External supervisors
- Gateway profiling
- Query a running Gateway
gateway healthgateway usage-costgateway stabilitygateway diagnostics exportgateway statusgateway probe- Remote over SSH (Mac app parity)
gateway call <method>gateway suspendgateway resume <suspensionId>- Manage the Gateway service
- Recover an unreadable native service definition
- Lifecycle requests from Gateway chat
- Install with a wrapper
- Discover gateways (Bonjour)
gateway discover- Remote over SSH (Mac app parity)
gateway call <method>gateway resume <suspensionId>- Discover gateways (Bonjour)
Option, tab, and panel anchors:
- Startup behavior
--port--bind--token--auth--password--tailscale--allow-unconfigured--dev--ambient-channels--dev-ambient-channels--reset--force--verbose--cli-backend-logs--ws-log--compact--raw-stream- Output modes
- Shared options
--port--days--agent--all-agents--limit--type--since-seq--bundle--export- Privacy and bundle behavior
--log-lines--log-bytes--url--token--password--timeout--no-stability-bundle--json--url--port--token--password--timeout--no-probe--deep--require-rpc- Status semantics
- Linux systemd auth-drift checks
--port- Interpretation
- JSON output
- Common warning codes
--ssh--ssh-auto--params--url--port--token--password--timeout--expect-final--json- Command options
- Service runtime
- Lifecycle behavior
- Managed Gateway heap sizing
- Auth and SecretRefs at install time
--timeout--json
