iOS

iOS Node App 让你的 iPhone 或 iPad 成为 OpenClaw 的移动节点，为 Agent 提供语音、摄像头、位置和推送通知等能力。

系统要求

项目	要求
iOS 版本	16 及以上
设备	iPhone 8+ / iPad (6th gen)+
存储	200 MB 可用空间

安装方式

App Store

在 App Store 搜索 "OpenClaw Node" 下载安装。

TestFlight（测试版）

1. 在 iPhone 上安装 TestFlight
2. 打开 OpenClaw TestFlight 邀请链接
3. 点击「开始测试」安装最新测试版

获取 TestFlight 邀请

TestFlight 测试版包含最新功能，可在 OpenClaw Discord 的 #ios-beta 频道获取邀请链接。

配对连接

iOS App 需要与 Gateway（网关）配对后才能使用：

步骤一：生成配对码

在网关所在设备上运行：

openclaw pairing --generate

或生成 QR Code（二维码）：

openclaw qr

步骤二：App 配对

1. 打开 iOS App，点击「配对新网关」
2. 扫描 QR Code 或手动输入配对码
3. 等待配对完成，状态显示为「已连接」

步骤三：验证连接

# 在网关端确认节点已上线
openclaw nodes

iOS 节点功能

推送通知

Agent 可以向你的 iPhone 发送通知：

# 网关配置
channels:
  ios_push:
    enabled: true
    sound: default
    badge: true

通知类型：

• 即时通知：Agent 有消息要告诉你
• 定时提醒：定时任务触发的提醒
• 紧急通知：可突破勿扰模式

Siri 集成

通过 Siri Shortcuts（快捷指令）与 OpenClaw 交互：

1. 在 iOS App 中进入「Siri 集成」设置
2. 添加快捷指令，如 "问问 OpenClaw"
3. 对 Siri 说 "问问 OpenClaw，今天天气怎么样"

用户：Hey Siri，问问 OpenClaw 明天的日程
Siri：[调用 OpenClaw] → Agent 返回日程信息 → Siri 朗读结果

位置服务

iPhone 的 GPS 为 Agent 提供高精度位置数据：

# 在 App 设置中配置
location:
  mode: fused
  update_interval: 60
  background: true         # 后台持续更新

位置权限

请在 iOS 设置中将 OpenClaw 的位置权限设为「始终允许」，否则后台位置更新将不可用。

语音交互

iOS 节点支持完整的语音交互能力：

• 实时语音录制和 STT
• TTS 语音播放
• 语音唤醒（需要 App 在前台或有后台音频权限）

后台处理限制

iOS 后台限制

iOS 对后台进程有严格限制，以下功能在 App 切到后台后可能受影响。

功能	后台状态	说明
推送通知	✅ 正常	通过 APNs 推送
位置更新	⚠️ 低频	仅重大位置变化时更新
语音录制	❌ 约3分钟后暂停	iOS 限制后台音频
摄像头	❌ 后台不可用	iOS 不允许后台访问
WebSocket 连接	⚠️ 可能断开	iOS 会暂停后台网络

优化后台运行

App 设置 → 后台模式 → 开启以下选项：
✅ 后台 App 刷新
✅ 位置更新
✅ 远程通知

同时在 iOS 系统设置中：

1. 设置 → 通用 → 后台 App 刷新 → 开启 OpenClaw
2. 设置 → OpenClaw → 位置 → 始终

电池优化

低功耗建议

# App 内配置
power:
  mode: balanced            # low_power / balanced / performance
  pause_on_low_battery: true
  battery_threshold: 20
  reduce_location_frequency: true

模式	电池影响	功能
low_power	最省电	仅推送通知和低频位置
balanced	适中（推荐）	按需语音 + 位置
performance	耗电最多	全部功能持续运行

预计电池消耗

场景	预计日耗电
仅推送通知	~2%
推送 + 低频位置	~5%
语音唤醒（前台）	~15%
全功能（前台）	~25%

完整配置示例

日常助手

node:
  type: mobile
  capabilities:
    audio: true
    camera: true
    location: true
    notifications: true
power:
  mode: balanced
location:
  update_interval: 300

语音助手

node:
  type: mobile
  capabilities:
    audio: true
    camera: false
    location: false
    notifications: true
talk:
  mode: push_to_talk
power:
  mode: low_power

故障排查

问题	解决方案
配对失败	确认手机和网关在同一局域网或网关可公网访问
通知收不到	检查 iOS 通知权限，确认 APNs 配置正确
后台断连	开启后台 App 刷新，关闭低电量模式
位置不更新	将位置权限改为「始终允许」
App 闪退	更新到最新版本，或通过 TestFlight 获取修复版