跳转到主要内容

​
Android 应用（节点）

​
支持概览

  • 角色：伴侣节点应用（Android 不托管 Gateway网关）。
  • 需要 Gateway网关：是（在 macOS、Linux 或通过 WSL2 的 Windows 上运行）。
  • 安装：入门指南 + 配对。
  • Gateway网关：运维手册 + 配置。

​
系统控制

系统控制（launchd/systemd）在 Gateway网关主机上。参见 Gateway网关。

​
连接运维手册

Android 节点应用 ⇄（mDNS/NSD + WebSocket）⇄ Gateway网关 Android 直接连接到 Gateway网关 WebSocket（默认 ws://<host>:18789）并使用 Gateway网关管理的配对。

​
前提条件

  • 你可以在”主”机器上运行 Gateway网关。
  • Android 设备/模拟器可以访问 Gateway网关 WebSocket：
    • 同一局域网且支持 mDNS/NSD，或
    • 同一 Tailscale tailnet，使用 Wide-Area Bonjour / 单播 DNS-SD（见下文），或
    • 手动指定 Gateway网关主机/端口（备用方案）
  • 你可以在 Gateway网关机器上（或通过 SSH）运行 CLI（openclaw）。

​
1）启动 Gateway网关

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

​
2）验证发现（可选）

在 Gateway网关机器上： 
dns-sd -B _openclaw-gw._tcp local.
更多调试说明：Bonjour。

​
Tailnet（Vienna ⇄ London）通过单播 DNS-SD 发现

Android NSD/mDNS 发现无法跨网络工作。如果你的 Android 节点和 Gateway网关在不同网络上但通过 Tailscale 连接，请改用 Wide-Area Bonjour / 单播 DNS-SD：
  1. 在 Gateway网关主机上设置 DNS-SD 区域（示例 openclaw.internal.）并发布 _openclaw-gw._tcp 记录。
  2. 配置 Tailscale split DNS，将你选择的域名指向该 DNS 服务器。
详情和示例 CoreDNS 配置：Bonjour。

​
3）从 Android 连接

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

​
4）审批配对（CLI）

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

​
5）验证节点已连接

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

​
6）聊天 + 历史记录

Android 节点的聊天界面使用 Gateway网关的主会话键（main），因此历史记录和回复与 WebChat 及其他客户端共享：
  • 历史记录：chat.history
  • 发送：chat.send
  • 推送更新（尽力而为）：chat.subscribe → event:"chat"

​
7）Canvas + 相机

​
Gateway网关 Canvas 主机（推荐用于 Web 内容）

如果你希望节点显示智能体可以在磁盘上编辑的真实 HTML/CSS/JS，请将节点指向 Gateway网关 canvas 主机。 注意：节点使用 canvasHost.port（默认 18793）上的独立 canvas 主机。
  1. 在 Gateway网关主机上创建 ~/.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 辅助工具。