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+)

相关链接