iOS：安装官方 App 并连接 OpenClaw

先看这条路线

在 iPhone 安装官方 OpenClaw App，再连接一台持续运行的 Gateway 主机。手机负责对话、查看结果和确认操作；Gateway 放在 Linux、Mac 或 Windows/WSL2 主机上。

1. 在 iPhone 安装官方 App

打开官方 App Store 安装页 ↗，确认应用为 OpenClaw、开发者为 OpenClaw Foundation，再点获取。目前要求 iOS 26.2 或以上；先在“设置 → 通用 → 关于本机”查看系统版本。商店显示不兼容或所在地区不可用时，以商店说明为准。官方 iOS 说明 ↗

2. 准备好自己的 Gateway 主机

没有主机时，先选一条本站教程：Linux、Mac 或 Windows。完成主机初始化和模型授权，在控制台发一条消息，收到回复后继续。模型账户与服务器可能各自收费。

在主机终端检查状态：

openclaw gateway status

主机应保持在线，电脑不要进入睡眠。后面的命令都在这台主机的终端执行。Gateway 入门 ↗

3. 给手机建立私有 HTTPS 访问路径

本教程采用 Tailscale：在主机及 iPhone 安装它，加入你管理的同一 tailnet；iPhone 按系统提示允许 VPN 配置并保持已连接。iPhone 安装 Tailscale ↗

在 Tailscale 管理控制台启用 MagicDNS 和 HTTPS 证书，并让网络访问规则允许手机访问主机的 TCP 443。Gateway 应已经完成 token 或密码认证；保留认证设置。在主机终端依次执行：

openclaw config set gateway.bind loopback
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
tailscale serve status

如果尚未安装 Gateway 后台服务，先按主机教程完成安装。复制实际输出的 https://主机名.你的tailnet.ts.net，在保持 Tailscale 连接的 iPhone Safari 打开，确认能到达自己的控制台。这个网址来自 Tailscale，无需另买域名；Serve 的访问范围为获准 tailnet 设备。私有 HTTPS 配置 ↗

4. 创建移动设置码，配对 iPhone

在主机控制台进入 Nodes / Devices，选择 Pair device，核对访问权限后创建 setup code。日常对话可先选 Limited access；需要管理网关设置时，再自行决定是否授予 Full access。控制台连接与配对 ↗

也可以在主机终端生成省去管理权限的移动二维码：

openclaw qr --limited

在 iPhone App 的 Settings → Gateway 扫描二维码或粘贴 setup code。同一部手机上操作时，粘贴设置码更方便。请选择移动设置码；devices join-code 用于节点加入。设置码含临时认证信息，保留给自己的设备使用。移动二维码说明 ↗

配对时使用自己主机生成的二维码或设置码。

匹配的官方 App 通常会自动完成连接。若显示 Pending approval，在主机执行：

openclaw devices list
openclaw devices approve REQUEST_ID

把 REQUEST_ID 替换为列表中这部 iPhone 当前请求的完整 ID；先核对设备和权限。重新配对可能产生新 ID，应重新查看列表。设备批准命令 ↗

5. 发出第一条任务

打开 App 对话，先发“请用三句话说明你能做什么”，收到回复后试一个小任务，再尝试语音或相机。使用相应功能时才开启所需权限；已授权项目可以在 iPhone 系统设置中调整。

Skills 装在实际运行 OpenClaw 的主机环境中。可继续阅读 Skills 来源与安装，在主机上添加需要的功能。

6. 连不上时逐项检查

• App 无法安装：检查系统版本、存储空间和商店地区。
• Safari 超时：检查主机在线、双方 Tailscale 已连接，以及 HTTPS / 443 访问规则。
• 设置码失效或提示 setup incomplete：从同一 Gateway 生成新的移动设置码，再扫描。
• 一直待批准：重新运行 openclaw devices list，检查当前请求及访问权限。
• 已连接但不回答：回到主机检查模型授权、额度和任务错误。

排查资料可参考官方连接诊断 ↗。对外求助前遮住 API Key、网关密码、设置码和客户资料。