iOS App

这个苹果手机上的 App，就像一个遥控小汽车。它需要找到并连接到一个叫“网关”的指挥中心（这个“网关”运行在另一台电脑上），然后就能听指挥中心的命令，帮你做很多事情啦。

你需要准备什么？

要玩这个，你需要两样东西：

1. 一个正在运行的“网关”程序。它可以在苹果电脑、普通电脑或者安装了 WSL2 的 Windows 电脑上运行。
2. 一条能让手机找到“网关”的路。有三条路可以选：
   • 最简单的是让它们俩在同一个 Wi-Fi 网络里（就像在同一个游乐场里玩）。
   • 如果不在同一个网络，可以用一个叫 Tailscale 的工具搭一座“网络桥”。
   • 如果上面两条路都不行，你还可以手动告诉手机“网关”住在哪里（它的地址和门牌号）。

快速开始：让手机和网关成为好朋友

我们来一步一步让它们认识并连接起来：

1. 启动网关：先在电脑上打开终端（像是一个对电脑说话的小窗口），输入命令 openclaw gateway --port 18789 并按下回车。这就像打开了指挥中心的大门。
2. 手机寻找网关：在手机的 App 里，打开“设置”，它会自动寻找附近的“网关”。如果找到了，就点选它。如果没找到，就打开“手动输入主机”的开关，然后填上电脑的地址和门牌号 18789。
3. 电脑上同意交友：这时，电脑的“网关”会收到一个交友请求。你需要回到电脑的终端窗口，输入 openclaw devices list 看看是谁想加好友，记住它的 requestId。然后输入 openclaw devices approve <requestId>（把 <requestId> 换成你看到的那个号码），按下回车，就同意啦！
4. 检查是否连上了：最后，在终端输入 openclaw nodes status 和 openclaw gateway call node.list --params "{}" 这两个命令，看看手机是不是已经成功加入，变成听话的“小帮手”了。

手机变身小画板

连接成功后，你的手机屏幕可以变成一块神奇的画布！你可以通过电脑命令，让手机打开一个特别的画画页面。

• 用这个命令：openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<网关的地址>:18789/__openclaw__/canvas/"}'（记得把 <网关的地址> 换成你电脑的真实地址）。手机就会打开画布啦。
• 画完了想回到 App 自己的页面？再用一次上面的命令，把网址 url 的部分改成 ""（两个引号中间空着）就可以了。

几个要注意的地方

• 声音功能：手机 App 里可以打开“语音唤醒”和“对话模式”。但要小心哦，如果 App 没有在最前面运行，手机可能会让它“睡觉”，声音功能就可能不灵了。
• 常见的麻烦和解决办法：
  • 如果电脑告诉你 NODE_BACKGROUND_UNAVAILABLE，意思是手机 App 躲到后台去了。你需要把手机 App 点开，放到最前面来。
  • 如果看到 A2UI_HOST_NOT_CONFIGURED，意思是“网关”没有准备好画布的地址。你需要去检查一下“网关”的配置。
  • 如果电脑上一直没弹出交友请求，就按上面第3步的方法，手动去同意。
  • 如果你重新安装了手机 App，可能需要重新和“网关”做一次朋友，因为之前的交友凭证不见了。

这个 App 还在成长中，如果遇到问题，可以去看看关于“如何交朋友”、“如何寻找网关”的其他说明书哦。