OpenClaw LaunchOpenClaw Launch
← 返回中文首页

使用教程

OpenClaw 安卓 App：安装、连接与实际用法

官方安卓 App 把手机变成 OpenClaw 的一个 AI 节点——摄像头、麦克风、屏幕和传感器都可以交给 AI 使用。本文讲清楚三件事：国内怎么装、怎么连上网关、连上之后能做什么。

先搞清楚：App 是「节点」，不是「网关」

这是最容易踩的坑。OpenClaw 安卓 App 是配套节点应用，它通过 WebSocket 连接到一个已经在运行的 OpenClaw 网关，把手机的硬件——摄像头、麦克风、屏幕、传感器—— 变成 AI 可以调用的工具。

换句话说，它负责「手和眼睛」，思考、模型路由和技能执行仍然发生在网关那一侧。 所以只装 App 是跑不起来的，你必须先有一个网关。

准备条件

  • 一个正在运行的 OpenClaw 网关：自建 Docker、本机安装，或者托管实例
  • 安卓 12 及以上的手机（应用的 minSdk 为 31）
  • OpenClaw 安卓 App（Google Play 或 APK 侧载）
  • 手机能访问到网关：同一局域网、Tailscale，或者一个公网地址

安装：国内优先用 APK

海外用户可以直接在 Google Play 安装官方应用（包名 ai.openclaw.app），好处是自动更新、 构建可校验。

中国大陆无法正常访问 Google Play，多数国行手机也不预装 Google 服务框架，用 APK 侧载即可：到 OpenClaw 官方 GitHub Releases 页下载最新 APK，在系统设置里对浏览器或文件管理器开启「安装未知来源应用」权限，然后打开 APK 安装。

APK 的代价：不会自动更新。建议每隔一段时间回 Releases 页看一眼版本， 或者关注官方仓库的发布通知。

三种连接网关的方式

三种方式都需要在网关侧批准。安卓端是以设备节点身份接入的，不管用哪种方式， 网关都会先挂起一个配对请求，要执行 openclaw devices approve <requestId> 批准后才连得上。 另外：局域网内地址、.local 主机名和 localhost 可以用明文 ws://；跨网络访问必须用 TLS。

方式一：局域网自动发现（mDNS / NSD）

手机和网关在同一个 Wi-Fi 下时，App 可以自动扫描到网关。

  1. 打开 App，进入 Connect 标签页
  2. 等待几秒，网关会出现在列表里
  3. 点击网关，按提示填入 Auth Token
扫不到？先确认两台设备在同一 Wi-Fi。部分家用路由器会屏蔽客户端之间的 mDNS 广播， 这种情况直接用方式三手动填地址。

方式二：Tailscale

在手机和网关所在机器上都装好 Tailscale 之后，即使手机切到移动数据也能连回网关。

注意，这里很容易配错：安卓端不支持直接填 tailnet 内网 IP 的 ws:// 地址。官方文档明确要求用 Tailscale Serve（或其他 TLS 端点） 提供的 https:// / wss:// MagicDNS 地址。填 http://100.x.y.z:18789 这种形式是连不上的。

Tailscale 依赖它自己的登录与协调服务，因此这条路能否稳定取决于你的网络环境。 如果连接经常断开或登录不上，直接换成方式三——用一个有公网域名的网关，链路更短也更好排查。

方式三：手动填写网关地址

只要网关有一个能访问的地址，手动填就行：

  1. 进入 Connect → Manual
  2. 填入完整地址，例如：
    • https://openclaw.yourdomain.com（自建反向代理 + HTTPS）
    • http://192.168.1.100:18789（局域网 IP）
    • https://your-instance.openclawlaunch.com（托管实例）
  3. 填入 Auth Token，点击 Connect

连接托管实例（最省事的一条路）

如果用的是 OpenClaw Launch 托管实例，流程是这五步：

  1. 在控制台打开你的实例详情页，找到 Gateway URL 和 Auth Token
  2. 打开 App，进入 Connect → Manual
  3. 填入实例的网关地址
  4. 填入 Auth Token，点击 Connect
  5. 在网关侧批准这台设备——用 openclaw devices list 看到待批准的请求， 再 openclaw devices approve <requestId>。批准之后状态才会变成 Connected
为什么托管更省事：实例本身已经配好 HTTPS 证书、Auth Token 和公网访问， 不需要自己处理反向代理、trustedProxies 或 allowInsecureAuth 这些设置， 也不需要家宽公网 IP。

连上之后能做什么

主导航是 Home、Chat、Settings 三个页面， 另外还有初次接入用的 Connect，以及 Settings 里的 Gateway（网关设置） 和 Approvals（审批）两块。

  • Home：设备与连接状态总览
  • Chat：和网关 Web UI 一样收发消息、查看历史；语音交互也在这里
  • Settings：网关连接、通知、权限与主题
  • Connect：首次接入时的网关发现与配对入口
  • Gateway：Settings 里的网关配置
  • Approvals：需要你确认的操作在这里审批

画布（canvas）不是独立标签页，而是 AI 需要显示内容时叠加出来的界面。

摄像头与画布

这两个是安卓 App 最有价值的能力：

  • 摄像头：首次使用时会请求权限。授权后 AI 可以拍照或读取实时画面， 用来识别物体、读取文档、判断现场情况——任何需要「看一眼」的任务。
  • 画布：AI 可以把图表、示意图、图片或交互元素直接画在手机屏幕上， 让手机变成一块由 AI 控制的动态显示屏。

已知限制

  • 摄像头和画布只在前台工作：切到别的应用后会暂停，回到 App 才恢复
  • 依赖网关在线：网关掉线时 App 无法独立工作，网关恢复后会自动重连
  • 手机不能当网关：App 只能连接网关，不能变成网关
  • 耗电：持续开摄像头或语音会明显增加耗电，可在 Settings 里控制

常见问题

没有服务器，只装 App 能用吗？

不能。安卓 App 是节点（node），不是网关（gateway）。它必须连到一个正在运行的 OpenClaw 网关上——可以是你自己的服务器、本机安装，也可以是 OpenClaw Launch 的托管实例。 App 本身不包含网关。

国内访问不了 Google Play，怎么安装？

用 APK 侧载。从 OpenClaw 官方 GitHub Releases 页下载最新 APK，在系统设置里允许「安装未知来源应用」， 再打开 APK 安装即可。缺点是不会自动更新，需要自己定期回去看新版本。

用移动数据（4G/5G）能连上吗？

可以，前提是网关能从公网访问。如果网关只在局域网里，手机离开这个 Wi-Fi 就连不上，需要内网穿透或 Tailscale 之类的方案。OpenClaw Launch 的托管实例本身就带公网 HTTPS 域名，这一步不用自己折腾。

需要配对吗？填了地址和 Token 就能用吗？

需要配对，但不是 Telegram 那种私聊发码。安卓端以 role: node 的身份做设备配对， 填完地址和 Token 之后会向网关发起一个配对请求，必须在网关侧批准才算连上：
openclaw devices list 查看待批准的请求，openclaw devices approve <requestId> 批准。
如果 App 一直卡在未连接状态，先去网关看有没有等待批准的请求——这是最常见的原因。

多台手机能连同一个网关吗？

可以。每台手机作为独立节点接入，网关统一管理所有已连接节点，并可以把任务分派给其中任意一台。

有 iOS 版吗？

有。官方 iOS 版于 2026 年 6 月 29 日发布，支持 iPhone、iPad 和 Apple Watch。

继续阅读

还没有网关？

OpenClaw Launch 提供托管实例，自带公网 HTTPS 域名和 Auth Token，部署完直接用 App 连上，不用自己配服务器和证书。

查看托管方案