Platforms 导读

iOS 端接入:先配网关,再配对,最后搞定推送

iOS 应用通过 WebSocket 连接同一局域网或 Tailnet 上的网关,暴露 Canvas、摄像头、位置等节点能力。最易踩坑的是配对流程:每次重试都会生成新的 requestId,必须重新执行 openclaw devices list 获取最新 ID 再 approve。官方构建版使用外部推送中继,网关需配置 relay baseUrl,且必须与 iOS 构建时内置的 URL 一致,否则推送失效。

先讲这一页到底在解决什么

iOS 端接入:先配网关,再配对,最后搞定推送

iOS 应用通过 WebSocket 连接同一局域网或 Tailnet 上的网关,暴露 Canvas、摄像头、位置等节点能力。最易踩坑的是配对流程:每次重试都会生成新的 requestId,必须重新执行 openclaw devices list 获取最新 ID 再 approve。官方构建版使用外部推送中继,网关需配置 relay baseUrl,且必须与 iOS 构建时内置的 URL 一致,否则推送失效。

原文共 16 节,先看 Start Here 路径:/platforms/ios 查看官方原文

第一站

🧭 先找到 Gateway,再领设备工牌

这页最核心的流程就是发现、连接、审批。

openclaw gateway --port 18789

先把 Gateway 开起来,相当于先把总指挥室点亮。

Bonjour / tailnet / 手填 host

iOS app 会尽量自动找路,找不到时再手工填门牌号。

openclaw devices approve <requestId>

这句像给 iPhone 发 node 工牌,拿到后它才算正式入队。

会什么

Canvas、截图、相机、定位、Talk、Voice Wake,都是它这边擅长的体能活。