Skip to content

使用 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 ​

  1. 在 Olares 中打开设置 > 应用 > OpenClaw。
  2. 在入口中打开 OpenClaw Gateway,复制它的域名,并保持认证级别为 Internal(内部)。

Gateway 入口不会显示在启动台中。它的地址与 OpenClaw CLI、Control UI 和 Olares 桌面地址不同。如果使用克隆应用,请选择对应实例的 Gateway 入口。

下文用 efa2f8ec2.yourolaresid.olares.com 表示此域名,请替换为实际值。完整连接地址为 wss://efa2f8ec2.yourolaresid.olares.com,使用 443 端口和 TLS。通过 Olares 入口连接时,不要填写内部服务端口 18789。

安装并连接客户端 ​

审批待配对设备 ​

  1. 保持手机停留在连接界面,并开启 LarePass VPN。在 OpenClaw CLI 中运行:

    bash
    openclaw devices list
  2. 在 Pending 表中,通过设备名称和设备 ID 确认自己的手机,核对申请的角色与权限。使用此列表中的当前 Request ID:

    bash
    openclaw devices approve <requestId>
  3. 返回手机,重试连接或确认已完成审批。

  4. 再次运行 openclaw devices list。手机应用同时使用 node 和 operator 连接;如果自己的手机出现另一条请求,请核对后审批该当前请求。

Request ID 可能变化

如果重试时申请的角色、权限范围或公钥发生变化,Gateway 可能用新的 Request ID 替换待审批请求。手机仍可能保留之前的错误信息和 ID。

遇到 unknown requestId 或手机与 CLI 的 ID 不一致时,请刷新 openclaw devices list,使用已核实设备的当前请求。不要反复审批旧 ID,也不要审批无关设备。如果手机已经在 Paired 列表中,且没有待审批请求,重新连接即可,无需再次审批。

验证本地和外网访问 ​

  1. 将 OpenClaw 保持在手机前台,并检查连接:

    bash
    openclaw devices list
    openclaw nodes status

    手机应显示为已配对,应用处于前台时节点应处于已连接状态。

  2. 发送一条简短聊天消息并确认收到回复。配对成功本身并不能证明模型配置正确。

  3. 保持 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生成新的二维码或配对码,重新配对,以获得节点和操作员两类凭据。

了解更多 ​