Files

Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone

What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build

2026-02-02 16:38:25 +01:00

3.8 KiB

Raw Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

配对或重新连接 iOS 节点

从源码运行 iOS 应用

调试 Gateway网关发现或画布命令

iOS 节点应用：连接 Gateway网关、配对、画布及故障排除

iOS 应用

generated_at	model	provider	source_hash	source_path	workflow
2026-02-01T21:32:23Z	claude-opus-4-5	pi	692eebdc82e4bb8dc221bcbabf6a344a861a839fc377f1aeeb6eecaa4917a232	platforms/ios.md	15

iOS 应用（节点）

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

功能说明

通过 WebSocket 连接到 Gateway网关（局域网或 tailnet）。
暴露节点能力：画布、屏幕快照、摄像头捕获、位置、对话模式、语音唤醒。
接收 node.invoke 命令并上报节点状态事件。

要求

Gateway网关运行在另一台设备上（macOS、Linux 或通过 WSL2 的 Windows）。
网络路径：
- 通过 Bonjour 的同一局域网，或
- 通过单播 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（局域网）

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

Tailnet（跨网络）

如果 mDNS 被阻止，请使用单播 DNS-SD 区域（选择一个域名；示例：openclaw.internal.）和 Tailscale 分割 DNS。参阅 Bonjour 了解 CoreDNS 配置示例。

手动主机/端口

在设置中，启用手动主机并输入 Gateway网关主机 + 端口（默认 18789）。

画布 + A2UI

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

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

注意事项：

Gateway网关画布主机提供 /__openclaw__/canvas/ 和 /__openclaw__/a2ui/ 服务。
iOS 节点在连接时如果画布主机 URL 已广播，会自动导航到 A2UI。
使用 canvas.navigate 和 {"url":""} 返回内置脚手架页面。

画布执行 / 快照

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 应用切换到前台（画布/摄像头/屏幕命令需要前台运行）。
A2UI_HOST_NOT_CONFIGURED：Gateway网关未广播画布主机 URL；请检查 Gateway网关配置中的 canvasHost。
配对提示始终未出现：运行 openclaw nodes pending 并手动批准。
重新安装后重连失败：钥匙串中的配对令牌已被清除；请重新配对节点。

3.8 KiB Raw Blame History Unescape Escape