根据官方 Android 文档,Android App 的角色是:
- companion node app
也就是说,Android 在 OpenClaw 体系里更像一个移动节点,而不是 Gateway 中心本体。
一个最重要的结论
Android 不托管 Gateway。
官方文档写得非常明确:
- Android does not host the Gateway
- Gateway 必须运行在 macOS、Linux 或 Windows(WSL2)上
这意味着 Android 更适合:
- 查看状态
- 远程控制
- 作为移动入口
- 作为节点暴露设备能力
Android 是怎么连到系统里的
官方文档给出的连接结构是:
Android App ⇄ (mDNS/NSD + WebSocket) ⇄ Gateway
默认 WebSocket 端口是:
ws://<host>:18789
连接前需要满足什么
根据官方文档,前提条件包括:
- 你已经在“主机”上跑起了 Gateway
- Android 设备可以连到 Gateway WebSocket
- 你能在 Gateway 主机上运行 CLI
连接方式可以是:
- 同一局域网
- 同一 Tailscale tailnet
- 手动填写主机和端口
标准连接流程
官方 runbook 的顺序可以简化成:
- 在主机上启动 Gateway
- Android App 打开 Connect
- 选择 Setup Code 或 Manual mode
- 连接后进行设备配对
- 在 Gateway 主机上批准配对
官方批准命令:
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
配对完成后怎么验证
官方建议:
openclaw nodes status
openclaw gateway call node.list --params "{}"
Android 真正有价值的地方
官方文档里,Android 不只是“能聊天”,它还能作为节点提供:
- Chat
- Canvas
- Camera
- Voice
- 更多 Android 设备命令面
这意味着 Android 更像“随身设备能力节点”,而不是“托管中心”。
不适合优先做什么
- 长期托管所有渠道
- 作为唯一 Gateway 中心
一个更稳的结构
对大多数人,我推荐:
- VPS / 家用主机 / Raspberry Pi 跑 Gateway
- Android 作为移动节点和控制端
- 通过 Tailscale 或局域网接入
这样最符合官方架构,也最稳定。