iOS 应用（Node）

可用性：内部预览版。iOS 应用尚未公开发布。

功能介绍

  • 通过 WebSocket 连接到 Gateway（局域网或 tailnet）。
  • 提供 node 能力：Canvas、屏幕快照、相机拍摄、位置、语音模式、语音唤醒。
  • 接收 node.invoke 命令并报告 node 状态事件。

使用要求

  • Gateway 需要运行在另一台设备上（macOS、Linux 或 Windows 通过 WSL2）。
  • 网络连接方式：
    • 通过 Bonjour 在同一局域网，或
    • 通过单播 DNS-SD 在 Tailnet（示例域名：openclaw.internal.），或
    • 手动输入主机/端口（备用方案）。

快速开始（配对 + 连接）

  1. 启动 Gateway：
openclaw gateway --port 18789

  1. 在 iOS 应用中，打开 Settings 并选择一个已发现的 gateway（或启用 Manual Host 并输入主机/端口）。

  2. 在 gateway 主机上批准配对请求：

openclaw nodes pending
openclaw nodes approve <requestId>
  1. 验证连接：
openclaw nodes status
openclaw gateway call node.list --params "{}"

发现方式

Bonjour（局域网）

Gateway 会在 local. 上广播 _openclaw-gw._tcp 服务。iOS 应用会自动列出这些服务。

Tailnet（跨网络）

如果 mDNS 被阻止，可以使用单播 DNS-SD 区域（选择一个域名；示例：openclaw.internal.）和 Tailscale 分离 DNS。 参考 Bonjour 查看 CoreDNS 示例。

手动输入主机/端口

在 Settings 中，启用 Manual Host 并输入 gateway 主机 + 端口（默认 18789）。

Canvas + A2UI

iOS node 会渲染一个 WKWebView canvas。使用 node.invoke 来控制它：

openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'

注意事项：

  • Gateway canvas host 提供 /__openclaw__/canvas/ 和 /__openclaw__/a2ui/ 服务。
  • 当 canvas host URL 被广播时，iOS node 会在连接时自动导航到 A2UI。
  • 使用 canvas.navigate 和 {"url":""} 可以返回到内置界面。

Canvas 执行 / 快照

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'
openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

语音唤醒 + 语音模式

  • 语音唤醒和语音模式可以在 Settings 中使用。
  • iOS 可能会暂停后台音频；当应用不在前台时，语音功能可能无法保证正常工作。

常见错误

  • NODE_BACKGROUND_UNAVAILABLE：把 iOS 应用切换到前台（canvas/相机/屏幕命令需要应用在前台）。
  • A2UI_HOST_NOT_CONFIGURED：Gateway 没有广播 canvas host URL；检查 Gateway 配置 中的 canvasHost。
  • 配对提示从未出现：运行 openclaw nodes pending 并手动批准。
  • 重新安装后重新连接失败：Keychain 中的配对 token 被清除了；需要重新配对 node。

相关文档