使用 Openclaw 移动客户端连接
使用 OpenClaw 手机应用与 Olares 上运行的智能体聊天。完成一次配对后,在家中或外出时都可保持 LarePass VPN 开启,使用同一个 Gateway 地址连接。
前提条件
- 在 Olares 上完成 OpenClaw 初始化,并配置聊天所需的模型。
- 在手机上安装 LarePass,登录拥有此 OpenClaw 实例的 Olares 账户。
- 将 OpenClaw 升级到 Chart 版本 1.0.47 或更高版本。
重要
无论使用本地 Wi-Fi 还是移动数据,都应保持移动端 LarePass VPN 开启。在局域网内,LarePass 会自动使用 Intranet 连接。OpenClaw 的令牌或配对码不能替代 Olares 入口认证。
确认 Gateway 地址和 Auth Level
- 在 Olares 中打开设置 > 应用 > OpenClaw。
- 在入口中打开 OpenClaw Gateway,复制它的域名,并保持认证级别为 Internal(内部)。
Gateway 入口不会显示在启动台中。它的地址与 OpenClaw CLI、Control UI 和 Olares 桌面地址不同。如果使用克隆应用,请选择对应实例的 Gateway 入口。
下文用 efa2f8ec2.yourolaresid.olares.com 表示此域名,请替换为实际值。完整连接地址为 wss://efa2f8ec2.yourolaresid.olares.com,使用 443 端口和 TLS。通过 Olares 入口连接时,不要填写内部服务端口 18789。
安装并连接客户端
审批待配对设备
保持手机停留在连接界面,并开启 LarePass VPN。在 OpenClaw CLI 中运行:
bashopenclaw devices list在 Pending 表中,通过设备名称和设备 ID 确认自己的手机,核对申请的角色与权限。使用此列表中的当前 Request ID:
bashopenclaw devices approve <requestId>返回手机,重试连接或确认已完成审批。
再次运行
openclaw devices list。手机应用同时使用node和operator连接;如果自己的手机出现另一条请求,请核对后审批该当前请求。
Request ID 可能变化
如果重试时申请的角色、权限范围或公钥发生变化,Gateway 可能用新的 Request ID 替换待审批请求。手机仍可能保留之前的错误信息和 ID。
遇到 unknown requestId 或手机与 CLI 的 ID 不一致时,请刷新 openclaw devices list,使用已核实设备的当前请求。不要反复审批旧 ID,也不要审批无关设备。如果手机已经在 Paired 列表中,且没有待审批请求,重新连接即可,无需再次审批。
验证本地和外网访问
将 OpenClaw 保持在手机前台,并检查连接:
bashopenclaw devices list openclaw nodes status手机应显示为已配对,应用处于前台时节点应处于已连接状态。
发送一条简短聊天消息并确认收到回复。配对成功本身并不能证明模型配置正确。
保持 LarePass VPN 开启,关闭 Wi-Fi 并切换到移动数据。使用同一个已保存的 Gateway 地址重新连接,再发送一条消息。
切换网络时无需修改域名、端口或 TLS 设置。手机系统可能挂起后台应用,测试节点能力时请将应用切回前台。
故障排查
| 现象 | 检查方法 |
|---|---|
Expected HTTP 101 response but was '400 Bad Request' | WebSocket 握手在配对前失败。先检查本机 LarePass VPN 是否开启、主机是否为 Gateway 入口,以及是否使用 443 和 TLS。仅凭 400 无法确定是哪个代理返回的错误。 |
| 二维码包含回环地址、容器 IP 或错误域名 | 使用 openclaw qr --url 'wss://efa2f8ec2.yourolaresid.olares.com' 重新生成。 |
| 配对码过期或被拒绝 | 重新生成二维码并扫码配对。不要将二维码中的配对凭据填入手动设置的令牌栏。 |
| 令牌认证失败 | 从当前 OpenClaw 实例重新获取令牌。不要使用 Olares 密码或其他克隆实例的令牌。 |
| 使用手机客户端上的配对命令失败 | 在 OpenClaw CLI 中运行 openclaw devices list,找到自己手机的待配对请求,再运行 openclaw devices approve <requestId>。客户端显示的 requestId 可能不是最后一次配对请求,以 CLI 中的当前 requestId 为准。 |
pairing required 或 unknown requestId | 按审批待配对设备操作,使用自己手机的最新请求。 |
| CLI 已显示配对成功,手机仍显示旧错误 | 保持 VPN 开启并重新连接,必要时关闭并重新打开手机应用。 |
iOS 显示 Gateway setup incomplete | 生成新的二维码或配对码,重新配对,以获得节点和操作员两类凭据。 |