定位:移动节点,而非独立网关
OpenClaw Android 应用不是一个独立的 AI 客户端,而是作为「节点」接入 Gateway。Gateway 可以运行在 macOS、Linux 或 Windows(WSL2)上,Android 手机通过 WebSocket 连接到 Gateway 的 ws://<host>:18789 端口,成为 AI 助手的移动端感知延伸。
目前 Android 应用尚未公开发布,但源码已包含在 OpenClaw 仓库中,开发者可自行构建。
构建与安装
需要 Java 17 和 Android SDK 环境:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./gradlew :app:assemblePlayDebug
编译完成后将 APK 安装到 Android 设备。
连接配置
第一步:启动 Gateway
openclaw gateway --port 18789 --verbose
第二步:确认服务发现(可选)
dns-sd -B _openclaw-gw._tcp local.
第三步:在手机上连接
打开 App 的「Connect」标签,选择通过局域网自动发现,或手动输入 Gateway 的 IP 地址和端口。支持三种网络接入方式:
- 局域网 mDNS/NSD 自动发现
- Tailscale 私有网络
- 手动指定 IP:端口
第四步:审批配对请求
openclaw devices list
openclaw devices approve <requestId>
第五步:确认节点在线
openclaw nodes status
核心功能
摄像头与视频: 支持拍摄 JPG 照片和 MP4 视频片段,需授权 CAMERA 和 RECORD_AUDIO 权限。AI 助手可以主动调用摄像头来「看」你面前的内容。
Canvas 画布: 在 WebView 中渲染 Gateway 推送的 HTML/CSS/JS 页面,支持文件变更时自动热重载。
openclaw nodes invoke --node "<Android Node>" --command canvas.navigate \
--params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'
语音功能: 麦克风开关、实时转录,以及 ElevenLabs 或系统 TTS 语音合成。
短信发送: Android 专属功能,需授权 SMS 权限且设备支持电话功能,可让 AI 代你发送短信。
设备信息与传感器: 联系人、日历、通话记录、运动传感器等(均需相应权限)。
跨网络访问
如需从外网访问 Gateway,推荐使用 Tailscale:
在 ~/.openclaw/openclaw.json 中设置:
{
"gateway": {
"bind": "tailnet"
}
}
这样 Gateway 会绑定到 Tailscale 网络接口,手机和 Gateway 都加入同一个 tailnet 即可跨网络稳定连接。
注意事项
- Canvas 和摄像头功能要求 App 在前台运行,后台调用会返回
NODE_BACKGROUND_UNAVAILABLE错误 - 系统服务管理(launchd/systemd)运行在 Gateway 宿主机上,而非 Android 设备
- 建议在 Android 系统设置中将 OpenClaw 加入电池优化白名单,避免被系统强制休眠