首页 资讯 下载 教程 Skills 社群

Android 应用配置与使用

定位:移动节点,而非独立网关

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 视频片段,需授权 CAMERARECORD_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 加入电池优化白名单,避免被系统强制休眠