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 INLINECODE1
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_OPENCLAW value - Password: use your SERVICE_PASSWORD_OPENCLAW value

- Optional embedded form:

- INLINECODE6

2. Get Gateway Token

cat /data/.openclaw/openclaw.json | grep -A 2 '"token"'

Token is under: CODEBLOCK1

3. Enter Token in UI

- On Overview page, click Gateway Token field
Paste token
Click Connect

4. Approve Pairing (CLI)

CODEBLOCK2

5. Verify Success

- In Control UI: status shows green “OK” and dashboard loads
CLI:

  openclaw status --deep

Check Gateway → reachable and channels show OK.

Troubleshooting

- Page stays on form? WebSocket URL may need to be filled (usually left blank for remote)
Pairing fails? Run openclaw devices list again to see pending requests
Token invalid? Check /data/.openclaw/openclaw.json for correct value

网关控制界面登录与配对

当用户需要访问OpenClaw网关控制界面、进行身份验证、配对设备并确认连接时使用。

前置条件

- OpenClaw网关正在运行（openclaw status）
控制界面URL已在gateway.controlUi.allowedOrigins中配置
网关令牌可在配置文件中获取（/data/.openclaw/openclaw.json）
设备配对已获批准（CLI）

操作步骤

1. 打开控制界面

- URL：使用已配置的OpenClaw服务URL（来自gateway.controlUi.allowedOrigins）
HTTP基本认证：

- 用户名：使用您的SERVICEUSEROPENCLAW值 - 密码：使用您的SERVICEPASSWORDOPENCLAW值

- 可选的内嵌表单：

- https://<用户名>:<密码>@<您的-openclaw-域名>/

2. 获取网关令牌

bash cat /data/.openclaw/openclaw.json | grep -A 2 token

令牌位于：
json
gateway: { auth: { token: 您的令牌 } }

3. 在界面中输入令牌

- 在概览页面上，点击网关令牌字段
粘贴令牌
点击连接

4. 批准配对（CLI）

bash openclaw devices list openclaw devices approve <请求ID>

5. 验证成功

- 在控制界面中：状态显示绿色OK且仪表板加载成功
CLI：

bash openclaw status --deep

检查网关 → 可达性和通道显示OK。

故障排除

- 页面停留在表单？WebSocket URL可能需要填写（通常远程连接时留空）
配对失败？再次运行openclaw devices list查看待处理的请求
令牌无效？检查/data/.openclaw/openclaw.json中的值是否正确

gateway-control-ui网关控制界面