Android：安装官方 App 并连接 OpenClaw

先看这条路线

Android 安装官方 OpenClaw App，通过私有 HTTPS 连接自己的 Gateway，随后对话与确认任务。Gateway 在 Linux、Mac 或 Windows/WSL2 主机运行，Android App 是它的移动伴侣。官方 Android 说明 ↗

1. 选择官方安装入口

优先打开官方 Google Play 页面 ↗，核对 OpenClaw、OpenClaw Foundation 和应用标识 ai.openclaw.app，按商店要求安装。

不能使用 Google Play 时，从官方 GitHub Releases ↗选择同时列出 OpenClaw-Android.apk 和 OpenClaw-Android-SHA256SUMS.txt 的版本。选择同时提供这两个文件的发行版本。官方 APK 核验步骤 ↗

下载两份文件后，在电脑核对 APK 的 SHA-256 与校验文件对应项，官方还提供 GitHub 构建证明验证方法。确认后传到自己的手机，仅允许这次安装所用来源安装未知应用，完成后关闭该来源权限。长期更新尽量保持同一渠道；切换 Play / 独立 APK 可能需要卸载并丢失本地数据。

2. 准备一台已经能回答的 Gateway

先完成 Linux、Mac 或 Windows 主机教程，在主机控制台连接模型并发一条消息。服务器和模型可能分别收费。

在 Gateway 主机终端执行：

openclaw gateway status

保证主机在线，个人电脑保持唤醒。接下来所有命令都在这台主机执行。Gateway 入门 ↗

3. 建立手机能访问的私有 HTTPS

在主机和 Android 安装 Tailscale，加入自己管理的同一 tailnet；手机允许 VPN 连接并保持已连接。Android 安装 Tailscale ↗

在 Tailscale 管理控制台启用 MagicDNS 与 HTTPS 证书，允许手机访问主机 TCP 443。在已设置 token 或密码认证的 Gateway 主机终端执行：

openclaw config set gateway.bind loopback
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
tailscale serve status

没有安装后台服务时，先按主机教程完成安装。复制实际输出的 https://主机名.你的tailnet.ts.net，在手机浏览器打开验证。Serve 为私有 tailnet 访问，无需另外购买域名。远程 Android 配对使用 HTTPS/WSS；ws://公网IP:18789 是未加密连接。私有 HTTPS 设置 ↗

4. 生成移动设置码并批准自己的手机

在主机 Control UI 的 Nodes / Devices → Pair device 创建移动 setup code。先查看访问权限；普通对话可选 Limited access，需要管理设置时再决定 Full access。控制台配对 ↗

也可在主机终端生成：

openclaw qr --limited

首次打开 Android App，选择 Scan QR or setup code；或在 Settings → Gateway → Add Gateway 扫描／粘贴移动设置码。此处填写手机配对专用的移动设置码。二维码与设置码 ↗

配对时使用自己主机生成的二维码，保留给自己的设备使用。

按 App 显示核对申请的能力和权限。官方匹配的 App 通常能自动连接；仍有待批准请求时，在主机执行：

openclaw devices list
openclaw devices approve REQUEST_ID

将 REQUEST_ID 替换为这部手机当前的完整请求 ID。核对身份与权限后批准，再回 App 按提示继续；如果重新尝试产生新 ID，先刷新设备列表。设备批准说明 ↗

5. 先聊天，再按需开启手机能力

发“帮我列一个三项待办清单”，确认收到回复，再尝试语音或图片。相机、麦克风、位置等权限只在需要对应功能时开启；通知与后台运行按应用及系统提示设置，系统省电限制可能影响重连。

Skills 仍安装在 OpenClaw 的主机环境。按 Skills 来源与安装添加需要的功能。

6. 常见问题按顺序查

• 无法安装 APK：检查官方文件、校验结果、系统兼容性及当前安装渠道。
• 浏览器打不开主机：检查 Tailscale、主机在线情况、DNS 与 443 规则。
• 配对提示安全端点错误：使用实际 HTTPS / WSS 地址，重新生成移动设置码。
• 请求一直待批准：重新查看 openclaw devices list，核对这部手机最新请求。
• 连接正常但没回复：在主机检查模型授权、额度和错误信息。

参考官方故障排查 ↗。求助截图应遮住设置码、网关密码、API Key 和客户信息。