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基本认证：
- 用户名：使用您的SERVICE
USEROPENCLAW值
- 密码：使用您的SERVICE
PASSWORDOPENCLAW值
- 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中的值是否正确
