將你的 iOS 裝置變成 OpenClaw Node

開發行動端自動化最痛苦的就是設備連接。你可能試過各種方案，但總是卡在繁瑣的網路配置或權限限制。如果能直接讓手機變成一個可以被遠端控制的 Node，處理 Canvas 渲染或語音指令，開發體驗會順手很多。

目前的 iOS App 處於 internal preview 階段，雖然還沒公開發佈，但它已經能讓你的 iPhone 或 iPad 直接與 Gateway 連接，並暴露 Canvas、螢幕快照、相機、位置、對話模式以及語音喚醒等能力。

需要準備的東西

在開始之前，請確保你已經準備好：

• 運行在其他裝置（macOS, Linux 或 Windows WSL2）上的 Gateway
• 穩定的網路路徑（支援同區域網路 Bonjour、Tailnet 或手動指定 host/port）

快速開始

只要 5 分鐘，你就能完成配對並開始調用：

1. 啟動 Gateway：

   openclaw gateway --port 18789

2. App 設定： 在 iOS App 中開啟 Settings，選擇偵測到的 Gateway。如果沒看到，請開啟 Manual Host 並手動輸入 host/port。

3. 核准配對： 在 Gateway 運行的主機上執行以下指令來核准請求：

   openclaw nodes pending
   openclaw nodes approve <requestId>

4. 驗證連線：

   openclaw nodes status
   openclaw gateway call node.list --params "{}"

探索連線路徑

iOS Node 支援多種發現方式，你可以根據你的網路環境選擇：

• Bonjour (LAN)：Gateway 會在 local. 網域廣播 _openclaw-gw._tcp，App 會自動列出這些裝置。
• Tailnet (跨網路)：如果 mDNS 被阻擋，可以使用 unicast DNS-SD（例如 openclaw.internal.）搭配 Tailscale split DNS。
• 手動模式：在 Settings 開啟 Manual Host，直接輸入 Gateway 的 host 與 port（預設為 18789）。

Canvas 與 A2UI

iOS Node 會渲染一個 WKWebView Canvas。你可以透過 node.invoke 來操控它：

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

如果你想測試 Canvas 繪圖或抓取快照，可以參考以下範例：

Canvas eval 繪圖：

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

語音喚醒與對話

你可以在 Settings 中開啟語音喚醒與對話模式。不過要注意，iOS 可能會暫停背景音訊，所以當 App 不在前景時，請將語音功能視為 best-effort（盡力而為）。

疑難排解

遇到問題時，先檢查這些常見錯誤：

• NODE_BACKGROUND_UNAVAILABLE：請將 iOS App 移至前景，Canvas、相機與螢幕指令需要 App 處於活動狀態。
• A2UI_HOST_NOT_CONFIGURED：Gateway 沒有廣播 Canvas host URL。請檢查 Gateway 設定檔中的 canvasHost。
• 配對提示沒出現：手動執行 openclaw nodes pending 並核准。
• 重新安裝後連線失敗：這通常是因為 Keychain 中的配對 token 被清空了，請重新執行配對流程。

如果你需要更進一步的協助，可以詢問 AI Setup Assistant。

下一步

• Pairing
• Discovery
• Bonjour
• Gateway Configuration