13.5 Android应用

Android 应用作为"配套节点应用"，需要一个单独运行在 macOS、Linux 或 Windows（通过 WSL2）上的 Gateway 实例。

关键要求

• Gateway 依赖 - 必须在另一台机器上单独运行
• 连接方式 - 直接通过 WebSocket 连接到 Gateway（默认端口 18789）
• 发现机制 - 使用 mDNS/NSD 或手动配置来定位 Gateway

连接设置步骤

1. 启动 Gateway

在 Gateway 机器上执行启动命令，指定端口并启用详细日志：

# 启动 Gateway
openclaw gateway start --port 18789 --verbose

2. 可选：发现验证

使用 DNS 服务发现工具确认 Gateway 在网络上可用：

# 在 Linux 上使用 avahi
avahi-browse -r _openclaw._tcp

# 在 macOS 上使用 dns-sd
dns-sd -B _openclaw._tcp

3. Android 配置

访问应用设置，选择已发现的 Gateway 或手动指定主机/端口详情。

4. 节点配对

在 Gateway 机器上通过命令行界面批准待处理的连接请求：

# 批准节点配对请求
openclaw nodes approve

5. 连接验证

通过命令行查询或 Gateway API 调用检查节点连接状态：

# 查看节点状态
openclaw nodes status

# 或通过 API
curl http://localhost:18789/api/nodes

功能特性

聊天集成

使用 Gateway 的主会话密钥与 WebChat 和其他客户端共享会话历史。

Canvas 和摄像头

• Canvas - 当指向 Gateway Canvas 主机时，支持 HTML/CSS/JS canvas 编辑功能
• 摄像头快照 - 拍照功能（仅前台，需权限）
• 视频录制 - 录像功能（仅前台，需权限）

网络选项

• 本地局域网 - 同一网络内的 mDNS/NSD 发现
• 远程网络 - Tailscale 集成，配合广域 Bonjour 实现跨位置连接
• 备用方案 - 手动输入 Gateway 主机/端口