跳转到主要内容

​
Android 应用(节点)

​
支持概览

​
系统控制

系统控制(launchd/systemd)位于网关主机上。参见网关。

​
连接运行手册

Android 节点应用 ⇄ (mDNS/NSD + WebSocket) ⇄ 网关 Android 直接连接到网关 WebSocket(默认 ws://<host>:18789)并使用网关拥有的配对。

​
前置条件

  • 你可以在”主”机器上运行网关。
  • Android 设备/模拟器可以访问网关 WebSocket:
    • 通过 mDNS/NSD 在同一局域网,或
    • 使用广域 Bonjour / 单播 DNS-SD 在同一 Tailscale tailnet(见下文),或
    • 手动网关主机/端口(备用方案)
  • 你可以在网关机器上(或通过 SSH)运行 CLI(openclaw)。

​
1) 启动网关

openclaw gateway --port 18789 --verbose
在日志中确认你看到类似内容:
  • listening on ws://0.0.0.0:18789
对于仅 tailnet 设置(推荐用于 Vienna ⇄ London),将网关绑定到 tailnet IP:
  • 在网关主机的 ~/.openclaw/openclaw.json 中设置 gateway.bind: "tailnet"。
  • 重启网关 / macOS 菜单栏应用。

​
2) 验证发现(可选)

从网关机器: 
dns-sd -B _openclaw-gw._tcp local.
更多调试说明:Bonjour。

​
通过单播 DNS-SD 的 Tailnet(Vienna ⇄ London)发现

Android NSD/mDNS 发现不会跨网络。如果你的 Android 节点和网关在不同网络但通过 Tailscale 连接,请改用广域 Bonjour / 单播 DNS-SD:
  1. 在网关主机上设置 DNS-SD 区域(例如 openclaw.internal.)并发布 _openclaw-gw._tcp 记录。
  2. 配置 Tailscale 分割 DNS,将你选择的域指向该 DNS 服务器。
详细信息和 CoreDNS 配置示例:Bonjour。

​
3) 从 Android 连接

在 Android 应用中:
  • 应用通过前台服务(持久通知)保持其网关连接活跃。
  • 打开设置。
  • 在已发现的网关下,选择你的网关并点击连接。
  • 如果 mDNS 被阻止,使用高级 → 手动网关(主机 + 端口)并连接(手动)。
首次成功配对后,Android 在启动时自动重新连接:
  • 手动端点(如果启用),否则
  • 最后发现的网关(尽力而为)。

​
4) 批准配对(CLI)

在网关机器上: 
openclaw nodes pending
openclaw nodes approve <requestId>
配对详情:网关配对。

​
5) 验证节点已连接

  • 通过节点状态: 
    openclaw nodes status
  • 通过网关: 
    openclaw gateway call node.list --params "{}"

​
6) 聊天 + 历史

Android 节点的聊天表使用网关的主会话键(main),因此历史和回复与 WebChat 和其他客户端共享:
  • 历史:chat.history
  • 发送:chat.send
  • 推送更新(尽力而为):chat.subscribe → event:"chat"

​
7) Canvas + 相机

​
网关 Canvas 主机(推荐用于 Web 内容)

如果你希望节点显示代理可以在磁盘上编辑的真实 HTML/CSS/JS,将节点指向网关 canvas 主机。 注意:节点使用 canvasHost.port 上的独立 canvas 主机(默认 18793)。
  1. 在网关主机上创建 ~/.openclaw/workspace/canvas/index.html。
  2. 将节点导航到它(局域网): 
openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18793/__openclaw__/canvas/"}'
Tailnet(可选):如果两个设备都在 Tailscale 上,使用 MagicDNS 名称或 tailnet IP 代替 .local,例如 http://<gateway-magicdns>:18793/__openclaw__/canvas/。 此服务器将实时重载客户端注入 HTML 并在文件更改时重新加载。 A2UI 主机位于 http://<gateway-host>:18793/__openclaw__/a2ui/。 Canvas 命令(仅前台):
  • canvas.eval、canvas.snapshot、canvas.navigate(使用 {"url":""} 或 {"url":"/"} 返回到默认脚手架)。canvas.snapshot 返回 { format, base64 }(默认 format="jpeg")。
  • A2UI:canvas.a2ui.push、canvas.a2ui.reset(canvas.a2ui.pushJSONL 旧版别名)
相机命令(仅前台;权限门控):
  • camera.snap(jpg)
  • camera.clip(mp4)
参见相机节点了解参数和 CLI 帮助器。