中文 iOS
约 3 分钟
- 原始链接：https://docs.openclaw.ai/zh-CN/platforms/ios
- 来源章节：6. 官方文档：平台、客户端与 Web 界面
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/zh-CN/platforms/ios
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
iOS 应用 - OpenClaw
简体中文
搜索...
Ctrl K
搜索...
Navigation
平台概览
iOS 应用
平台概览
macOS 配套应用
- macOS 开发设置
- 菜单栏
- 语音唤醒
- 语音浮层
- WebChat
- Canvas
- Gateway 网关生命周期
- 健康检查
- 菜单栏图标
- macOS 日志
- macOS 权限
- 远程控制
- macOS 签名
- macOS 上的 Gateway 网关
- macOS IPC
- Skills
- Peekaboo Bridge
在此页面
- iOS 应用（节点）
- 功能
- 要求
- 快速开始（配对 + 连接）
- 发现路径
- Bonjour（LAN）
- Tailnet（跨网络）
- 手动主机/端口
- Canvas + A2UI
- Canvas eval / snapshot
- 语音唤醒 + 对话模式
- [常见错误](http://docs.openclaw
.ai/zh-CN/platforms/ios#%E5%B8%B8%E8%A7%81%E9%94%99%E8%AF%AF)
平台概览
iOS 应用
iOS 应用（节点）
可用性：内部预览。iOS 应用尚未公开分发。
功能
- 通过 WebSocket（LAN 或 tailnet）连接到 Gateway 网关。
- 暴露节点能力：Canvas、屏幕快照、相机捕获、位置、对话模式、语音唤醒。
- 接收
node.invoke命令并报告节点状态事件。
要求
- Gateway 网关运行在另一台设备上（macOS、Linux 或通过 WSL2 的 Windows）。
- 网络路径：
- 通过 Bonjour 的同一 LAN，或
- 通过单播 DNS-SD 的 Tailnet（示例域：
openclaw.internal.），或 - 手动主机/端口（备选）。
快速开始（配对 + 连接）
- 启动 Gateway 网关：
openclaw gateway --port 18789- 在 iOS 应用中，打开设置并选择一个已发现的 Gateway 网关（或启用手动主机并输入主机/端口）。
- 在 Gateway 网关主机上批准配对请求：
openclaw nodes pending
openclaw nodes approve <requestId>- 验证连接：
openclaw nodes status
openclaw gateway call node.list --params "{}"
发现路径
Bonjour（LAN）
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_CONFIGURED：Gateway 网关未广播 canvas 主机 URL；检查 Gateway 网关配置 中的canvasHost。- 配对提示从未出现：运行
openclaw nodes pending并手动批准。 - 重新安装后重连失败：钥匙串配对令牌已被清除；重新配对节点。
相关文档
Ctrl+I
技术支持 This documentation is built and hosted on Mintlify, a developer documentation platform