手机扫码配对：从 Setup Code 到节点上线

手机 App 是配套节点，配对一次、长期自动重连。整个过程手机和网关要在同一网络可达（同局域网，或经 Tailscale 这类私有网络）。

OpenClaw 应用的 Gateway 连接页，显示在线状态与扫码入口 — Gateway 连接页：状态、重连、诊断与扫码

手机端操作

打开 App 的 Connect 标签页。
选 Setup Code 模式：扫描网关 Control UI 里的二维码，或在网关上跑 openclaw qr 生成设置代码后粘贴。
扫不了码就用 Manual 手动模式填主机与端口；局域网可用 ws://，跨网用 wss://。
提交后等待网关侧批准。

官方生成的设置代码会把手机作为节点接入，并默认授予完整网关操作员权限；明文 ws:// 这类非加密连接会自动降为受限访问，设置页里能看到 Full 或 Limited 标识。想要受限配置可以跑 openclaw qr --limited 生成受限代码。

网关侧批准

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status     # 验证节点已连上

配对之后

自动重连：首次成功后，App 启动会自动连上已配对网关（靠设备发现的尽力而为，手动指定的地址则始终有效）。
前台服务：安卓用一条常驻通知维持连接，杀后台不影响。
多网关管理：Settings → Gateway 里列出所有已配对网关，可切换焦点；同一时间只有焦点网关拥有设备能力，避免两台网关同时指挥你的摄像头。
删除注册：Forget 会清掉该网关的凭据、令牌与缓存聊天记录。

连不上先查什么

手机与网关是否同网（不在同一网就上 Tailscale）。
网关日志里有没有看到连接进入（前台跑 --verbose 最直观）。
用了 Tailscale 却没加密端点的，参考网关排查。

配对成功就去发第一条消息。