ClawCN - OpenClaw 中文版

主题

iOS应用(节点) ​

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

功能 ​

  • 通过WebSocket连接到Gateway(局域网或Tailnet)。
  • 暴露节点功能:画布、屏幕快照、相机捕获、位置、对话模式、语音唤醒。
  • 接收node.invoke命令并报告节点状态事件。

要求 ​

  • Gateway在另一台设备上运行(macOS、Linux或通过WSL2的Windows)。
  • 网络路径:
    • 通过Bonjour的同一局域网,或
    • 通过单播DNS-SD的Tailnet(示例域:openclaw.internal.),或
    • 手动主机/端口(备用方案)。

快速开始(配对 + 连接) ​

  1. 启动Gateway:
bash
openclaw gateway --port 18789

  1. 在iOS应用中,打开设置并选择一个已发现的Gateway(或启用手动主机并输入主机/端口)。

  2. 在Gateway主机上批准配对请求:

bash
openclaw nodes pending
openclaw nodes approve <requestId>
  1. 验证连接:
bash
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示例。

手动主机/端口 ​

在设置中,启用手动主机并输入Gateway主机 + 端口(默认18789)。

画布 + A2UI ​

iOS节点渲染WKWebView画布。使用node.invoke来驱动它:

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

注意:

  • Gateway画布主机提供/__openclaw__/canvas/和/__openclaw__/a2ui/。
  • 当广播画布主机URL时,iOS节点在连接时自动导航到A2UI。
  • 使用canvas.navigate和{"url":""}返回到内置脚手架。

画布执行 / 快照 ​

bash
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\"; })()"}'
bash
openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

语音唤醒 + 对话模式 ​

  • 语音唤醒和对话模式在设置中可用。
  • iOS可能会暂停后台音频;当应用不活跃时,将语音功能视为尽力而为。

常见错误 ​

  • NODE_BACKGROUND_UNAVAILABLE:将iOS应用带到前台(画布/相机/屏幕命令需要它)。
  • A2UI_HOST_NOT_CONFIGURED:Gateway未广播画布主机URL;在Gateway配置中检查canvasHost。
  • 配对提示从未出现:运行openclaw nodes pending并手动批准。
  • 重新安装后重新连接失败:钥匙串配对令牌已清除;重新配对节点。

相关文档 ​