Android 应用尚未公开发布,源码在 apps/android,可用 Java 17 + Android SDK 自行构建(./gradlew :app:assemblePlayDebug)。
Android 不托管 Gateway,需要连接运行在 macOS/Linux/Windows(WSL2) 上的 Gateway。
连接方式
- 同 LAN:mDNS/NSD 自动发现
- 跨网络(Tailscale):Wide-Area Bonjour / unicast DNS-SD
- 手动:在 Advanced controls 中输入 host/port
安全要求:Tailscale 或公网连接必须使用 wss://(Tailscale Serve 或其他 TLS 端点),私有 LAN 地址仍支持 ws://。
配对流程
# 1. 启动 Gateway
openclaw gateway --port 18789 --verbose
# 2. Android 连接后,在 Gateway 主机审批
openclaw devices list
openclaw devices approve <requestId>可选:配置 CIDR 自动审批(仅限受控子网):
{
gateway: {
nodes: { pairing: { autoApproveCidrs: ["192.168.1.0/24"] } }
}
}节点能力
| 命令族 | 说明 |
|---|---|
canvas.* | WebView 画布(仅前台) |
camera.snap/clip | 拍照/录像(仅前台,需权限) |
device.* | 设备状态/信息/权限/健康 |
notifications.* | 通知列表/操作 |
contacts.* | 联系人搜索/添加 |
calendar.* | 日历事件 |
sms.search | 短信搜索 |
motion.* | 运动活动/计步 |
通知转发
{
notifications: {
allowPackages: ["com.slack", "com.whatsapp"],
denyPackages: ["com.android.systemui"],
quietHours: { start: "22:00", end: "07:00" },
rateLimit: 5
}
}需要 Android 通知监听权限。
语音模式
- Mic 模式:手动语音会话,每次停顿发送一轮
- Talk 模式:持续监听,直到手动关闭;需要
FOREGROUND_SERVICE_MICROPHONE声明(Android 14+)
相关链接
- platform-ios — iOS 节点应用
- platforms-index — 平台总览