Files
openclaw/docs/zh-CN/platforms/ios.md
Josh Palmer a3ec2d0734 Docs: update zh-CN translations and pipeline
What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
2026-02-03 13:23:00 -08:00

3.7 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
配对或重新连接 iOS 节点
从源码运行 iOS 应用
调试 Gateway 网关发现或 canvas 命令
iOS 节点应用:连接到 Gateway 网关、配对、canvas 和故障排除 iOS 应用
generated_at model provider source_hash source_path workflow
2026-02-03T07:52:17Z claude-opus-4-5 pi 692eebdc82e4bb8dc221bcbabf6a344a861a839fc377f1aeeb6eecaa4917a232 platforms/ios.md 15

iOS 应用(节点)

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

功能

  • 通过 WebSocketLAN 或 tailnet连接到 Gateway 网关。
  • 暴露节点能力Canvas、屏幕快照、相机捕获、位置、对话模式、语音唤醒。
  • 接收 node.invoke 命令并报告节点状态事件。

要求

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

快速开始(配对 + 连接)

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

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

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

发现路径

BonjourLAN

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

Tailnet跨网络

如果 mDNS 被阻止,使用单播 DNS-SD 区域(选择一个域;示例:openclaw.internal.)和 Tailscale 分割 DNS。 参见 Bonjour 了解 CoreDNS 示例。

手动主机/端口

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

Canvas + A2UI

iOS 节点渲染一个 WKWebView canvas。使用 node.invoke 来驱动它:

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

注意事项:

  • Gateway 网关 canvas 主机服务于 /__openclaw__/canvas//__openclaw__/a2ui/
  • 当广播了 canvas 主机 URL 时iOS 节点在连接时自动导航到 A2UI。
  • 使用 canvas.navigate{"url":""} 返回内置脚手架。

Canvas eval / snapshot

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"}'

语音唤醒 + 对话模式

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

常见错误

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

相关文档