教小白安卓手机如何安装 OpenClaw?
OPENCLAW 安卓安装指南
安卓手机如何安装 OpenClaw?一篇讲清官方路径和避坑重点
这段时间,很多人第一次接触 OpenClaw,都会先问一个问题:我能不能直接在安卓手机上把它装起来?
答案是可以用安卓手机接入 OpenClaw,但要先把一个关键事实说清楚。按照官方文档截至 2026 年 3 月 18 日的定义,Android 端是“节点应用”,不是独立托管 Gateway 网关的主机。换句话说,手机负责连接、聊天、画布和摄像头等能力,真正持续运行的核心网关,仍然建议放在 macOS、Linux,或者通过 WSL2 运行的 Windows 电脑上。
这个认知一旦弄明白,后面的安装就不容易走偏。很多人之所以觉得 OpenClaw 难装,不是步骤太多,而是一开始就把“安卓独立安装”和“安卓作为配套节点接入”混成了一件事。
先弄懂:安卓装的到底是什么
如果用一句话解释,OpenClaw 在安卓上的官方形态,更像是你的随身入口,而不是总控中心。
官方文档里写得很直接:Android 应用的角色是 companion node app,也就是配套节点应用;同时明确写到 Android does not host the Gateway。它会通过 WebSocket 连接到你自己的 Gateway 网关,默认端口是 18789。所以从体验上看,你是在手机里使用 OpenClaw;但从架构上看,真正让助手持续在线、接入渠道、管理会话和技能的,是另一台主机上的 Gateway。
这也解释了为什么很多教程会同时出现“手机安装”和“电脑开服务”两个步骤。不是教程啰嗦,而是官方设计本来就是这样。
安装前,你至少要准备这三样东西
第一样,是一台可以长期开着的主机。官方推荐的 Gateway 运行环境是 Node 22 及以上,系统可以是 macOS、Linux,或者 Windows 加 WSL2。
第二样,是你的安卓手机或安卓模拟器。它需要能访问那台主机上的 Gateway。如果两台设备在同一个局域网里,配置会最省心;如果不在同一网络,也可以走 Tailscale 一类方案,但复杂度会高一些。
第三样,是你能在主机上运行 openclaw 命令。因为安卓首次接入后,还需要在主机侧批准配对请求。
如果这三样没有准备齐,手机里就算打开了 OpenClaw 节点,也只能停留在“看得到入口,连不上服务”的状态。
官方推荐安装路径,分四步走
第一步:先在主机上安装 OpenClaw
官方推荐的方式,是先在主机终端里安装 OpenClaw CLI:
npm install -g openclaw@latest
openclaw onboard --install-daemon
其中 openclaw onboard --install-daemon 是很关键的一步。它不只是初始化,还会把 Gateway 守护服务装好,让 OpenClaw 能持续运行。
如果你想手动确认 Gateway 有没有起来,也可以执行:
openclaw gateway --port 18789 --verbose
当日志里出现类似 listening on ws://0.0.0.0:18789 的信息,说明网关已经在监听,安卓端就有机会连进来了。
官方入门地址可以直接看这两个:
官方文档:https://docs.openclaw.ai/ 中文站安装引导:https://openclaw.cc/
第二步:确认手机和网关能互相找到
在最理想的情况下,手机和主机连的是同一个 Wi-Fi,这时安卓应用通常可以通过局域网发现 Gateway。
如果发现不了,也别急。官方给了一个回退方式,就是在安卓应用里手动填写 Gateway 的主机地址和端口。默认端口就是 18789。
这一步最常见的问题有三个。
一是主机根本没开 Gateway。
二是手机和主机不在同一网络。
三是局域网发现被路由器、系统防火墙或者企业网络策略拦住了。
如果你是第一次装,建议先别追求“异地远程”。先在同一局域网里跑通,成功率最高。
第三步:在安卓端发起连接
按照官方 Android 文档,打开安卓应用后,进入设置页面,在“Discovered Gateways”里选择已经发现的网关,点击连接即可。
如果自动发现失败,就走“Advanced → Manual Gateway”,手动填入主机地址和端口,再点击手动连接。
需要注意的是,安卓端为了保持和 Gateway 的连接,会使用前台服务,也就是你会看到一个持续通知。这个不是异常,而是官方设计的一部分。没有这个前台服务,系统很容易把连接杀掉,消息和状态就不稳定了。
第四步:回到主机批准配对
这一步是很多新手最容易漏掉的。
安卓端发起连接后,主机端还要执行下面两条命令,查看待批准节点并完成配对:
openclaw nodes pending
openclaw nodes approve <requestId>
批准成功后,再运行:
openclaw nodes status
如果能看到节点在线,说明安卓手机已经真正接入 OpenClaw 体系了。到这里,聊天、历史记录同步,以及后续的画布能力,才算正式可用。
装好以后,安卓端能做什么
很多人以为安卓端只是个聊天壳子,其实不是。
按照官方平台文档,安卓节点接入后,可以共享主会话 main 的聊天历史,也可以承接 Canvas 画布内容,还支持摄像头相关能力。也就是说,你在电脑侧维护的 OpenClaw 助手,可以通过手机继续对话、查看界面、触发部分移动端能力。
这也是 OpenClaw 一个很有意思的设计思路。它不是把所有事情都塞进手机,而是把手机变成你随身携带的操作入口。真正吃资源、跑服务、管连接的工作,交给更稳定的主机。
新手最该避开的五个坑
第一个坑,是把安卓当成完整宿主机。
如果你按照“安卓独立部署全部服务”的预期去装,大概率会觉得教程前后矛盾。因为官方从一开始就没有把 Android 定位成 Gateway 主机。
第二个坑,是从第三方来源乱下安装包。
OpenClaw 现在热度很高,搜索结果里会混入各种二次打包站、镜像站和概念站。最稳妥的办法只有一个:优先看官方文档和官方 GitHub。不要因为“汉化版”“一键版”“免配置版”几个字,就把自己的账号和设备权限交出去。
第三个坑,是只装手机,不装主机端。
如果电脑或服务器那边没有网关,手机端再怎么点,也只是一个空入口。
第四个坑,是忽略网络连通性。
手机和主机都装好了,但不在同一网络,或者端口没通,最后表现出来通常只有一句话:连接不上。与其反复卸载重装,不如先检查主机日志、IP 地址和端口。
第五个坑,是忘了批准节点配对。
这一点太常见了。很多人看到手机上已经出现 Gateway 名称,就以为完成了。实际上,没有 approve 那一步,连接并没有真正建立。
如果你只想最快跑通,建议照这个顺序来
先在电脑上安装并启动 Gateway。
再让手机和电脑连同一个 Wi-Fi。
接着在安卓端自动发现网关并发起连接。
最后回到电脑上执行 openclaw nodes pending 和 openclaw nodes approve <requestId>。
这条路径虽然朴素,但最接近官方推荐流程,也是新手成功率最高的一条路。先跑通,再折腾远程访问、Tailscale、Canvas 和摄像头,会轻松很多。
写在最后
如果你要的是“安卓手机直接装一个完整的 OpenClaw 主机”,那截至 2026 年 3 月 18 日,官方给出的答案并不是这条路。官方支持的标准方式,是让安卓作为节点应用,连接到运行在 macOS、Linux 或 Windows WSL2 上的 Gateway 网关。
但如果你的目标是“用安卓手机随时随地访问自己的 OpenClaw 助手”,那这套方案其实已经很实用了。关键不是多会折腾,而是先把架构理解对:主机负责托管,手机负责接入。这个顺序一旦理顺,OpenClaw 的安装门槛会一下子降下来。
如果你正准备动手,最值得收藏的两个入口是:
官方 GitHub:https://github.com/openclaw/openclaw Android 平台文档:https://openclaw.cc/platforms/android

夜雨聆风