/install gateway-control-ui
Gateway Control UI Login & Pairing
Use when a user needs to access the OpenClaw Gateway Control UI, authenticate, pair a device, and confirm connectivity.
Prerequisites
- OpenClaw gateway running (
openclaw status) - Control UI URL configured in
gateway.controlUi.allowedOrigins - Gateway token available in config (
/data/.openclaw/openclaw.json) - Device pairing approval (CLI)
Steps
1. Open Control UI
- URL: use your configured OpenClaw service URL (from
gateway.controlUi.allowedOrigins) - HTTP Basic Auth:
- Username: use your
SERVICE_USER_OPENCLAWvalue - Password: use your
SERVICE_PASSWORD_OPENCLAWvalue
- Username: use your
- Optional embedded form:
https://\x3Cuser>:\x3Cpass>@\x3Cyour-openclaw-domain>/
2. Get Gateway Token
cat /data/.openclaw/openclaw.json | grep -A 2 '"token"'
Token is under:
"gateway": { "auth": { "token": "YOUR_TOKEN_HERE" } }
3. Enter Token in UI
- On Overview page, click Gateway Token field
- Paste token
- Click Connect
4. Approve Pairing (CLI)
openclaw devices list
openclaw devices approve \x3CrequestId>
5. Verify Success
- In Control UI: status shows green “OK” and dashboard loads
- CLI:
Checkopenclaw status --deepGateway→reachableand channels showOK.
Troubleshooting
- Page stays on form? WebSocket URL may need to be filled (usually left blank for remote)
- Pairing fails? Run
openclaw devices listagain to see pending requests - Token invalid? Check
/data/.openclaw/openclaw.jsonfor correct value
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gateway-control-ui - After installation, invoke the skill by name or use
/gateway-control-ui - Provide required inputs per the skill's parameter spec and get structured output
What is gateway-control-ui?
Step-by-step guide to log into the OpenClaw Control UI, enter gateway token, approve device pairing, and verify connection. It is an AI Agent Skill for Claude Code / OpenClaw, with 313 downloads so far.
How do I install gateway-control-ui?
Run "/install gateway-control-ui" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is gateway-control-ui free?
Yes, gateway-control-ui is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does gateway-control-ui support?
gateway-control-ui is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created gateway-control-ui?
It is built and maintained by lotfinity (@lotfinity); the current version is v1.0.0.