ClawCN - OpenClaw 中文版

主题

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)启动网关 ​

bash
openclaw gateway --port 18789 --verbose

在日志中确认您看到类似以下内容:

  • listening on ws://0.0.0.0:18789

对于仅 tailnet 设置(推荐用于维也纳 ⇄ 伦敦),将网关绑定到 tailnet IP:

  • 在网关主机的 ~/.openclaw/openclaw.json 中设置 gateway.bind: "tailnet"。
  • 重启网关/macOS 菜单栏应用。

2)验证发现(可选) ​

从网关机器:

bash
dns-sd -B _openclaw-gw._tcp local.

更多调试说明:Bonjour。

通过单播 DNS-SD 的 Tailnet(维也纳 ⇄ 伦敦)发现 ​

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

在网关机器上:

bash
openclaw nodes pending
openclaw nodes approve <requestId>

配对详情:网关配对。

5)验证节点已连接 ​

  • 通过节点状态:
    bash
    openclaw nodes status
  • 通过网关:
    bash
    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. 导航节点到它(局域网):

bash
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 辅助工具。