Skip to main content

​
Android 应用（节点）

​
支持快照

  • 角色：伴随节点应用（Android 不承载网关）
  • 需要网关：是（运行在 macOS、Linux 或通过 WSL2 的 Windows 上）
  • 安装：快速开始 + 配对

​
连接运行手册

Android 节点应用 ⇄ (mDNS/NSD + WebSocket) ⇄ 网关 Android 直接连接至网关 WebSocket（默认 ws://<host>:18789），使用设备配对（role: node）。

​
前提条件

  • 你可以在“主控”机器上运行网关
  • Android 设备/模拟器能够访问网关 WebSocket：
    • 在同一局域网且支持 mDNS/NSD，或者
    • 在同一 Tailscale tailnet，或者
    • 手动设置网关主机/端口

​
1) 启动网关

openclaw gateway --port 18789 --verbose

​
2) 验证发现（可选）

从网关机器执行： 
dns-sd -B _openclaw-gw._tcp local.

​
3) 从 Android 连接

在 Android 应用中：
  • 应用通过 前台服务（持续通知）保持网关连接活跃
  • 打开 连接 标签
  • 使用 设置码 或 手动 模式

​
4) 批准配对 (CLI)

在网关机器上： 
openclaw devices list
openclaw devices approve <requestId>

​
5) 验证节点已连接

openclaw nodes status
openclaw gateway call node.list --params "{}"

​
画布 + 屏幕 + 相机

​
网关画布主机

让节点导航至该地址： 
openclaw nodes invoke --node "<Android Node>" --command canvas.navigate \
  --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'
画布命令（仅前台）：
  • canvas.eval、canvas.snapshot、canvas.navigate
  • A2UI：canvas.a2ui.push、canvas.a2ui.reset
相机命令（仅前台；需授权）：
  • camera.snap（jpg）
  • camera.clip（mp4）
屏幕命令：
  • screen.record（mp4；仅前台）

​
语音 + 扩展的 Android 命令界面

  • 语音：Android 在语音标签中采用单一麦克风开启/关闭流程，支持转录捕获及 TTS 播放
额外的 Android 命令家族：
  • device.status、device.info、device.permissions、device.health
  • notifications.list、notifications.actions
  • photos.latest
  • contacts.search、contacts.add
  • calendar.events、calendar.add
  • motion.activity、motion.pedometer
  • app.update

​
常见错误

​
发现被阻止

使用 高级控制 中的手动主机/端口。

​
配对失败

执行 openclaw devices list 并手动批准。

​
画布命令失败

将应用切换到前台。

​
相关文档