📱 OpenClaw 手机节点控制完全指南
远程拍照 · 屏幕录制 · 文件传输 · 位置获取 · 通知管理
让 AI Agent 伸入物理世界
📅 2026-06-09
⏱️ 阅读 10 分钟
🏷️ Node Connect · Mobile · OpenClaw
1. 什么是 Node Connect？
Node Connect 是 OpenClaw 的设备连接功能，允许 AI Agent 与配对的手机、平板、电脑等设备进行双向通信。这意味着你的 AI 助手不再局限于屏幕上的文字，它可以：
| 能力 | 描述 | 工具 |
|---|
| 📸 远程拍照 | 用手机前/后摄像头拍照 | nodes camera_snap |
| 🎥 视频录制 | 录制短视频片段 | nodes camera_clip |
| 🖥️ 屏幕录制 | 录制手机屏幕操作 | nodes screen_record |
| 📍 位置获取 | 获取手机 GPS 位置 | nodes location_get |
| 🔔 通知管理 | 读取/操作手机通知 | nodes notifications_list |
| 📁 文件传输 | 双向传输文件 | file_fetch / file_write |
| 📂 目录浏览 | 浏览设备文件系统 | dir_list / dir_fetch |
💡 核心理念：Node Connect 让 AI Agent 从"数字世界助手"进化为"物理世界助手"。它可以帮你拍照记录、监控远程设备、自动备份文件，甚至在你不在时"看"周围环境。
2. 架构原理
┌─────────────┐ WebSocket ┌──────────────┐
│ OpenClaw │◄──────────────────►│ 手机 App │
│ Gateway │ 加密双向通道 │ (Node) │
└──────┬──────┘ └──────┬───────┘
│ API 调用 │ 系统权限
▼ ▼
┌─────────────┐ ┌──────────────┐
│ AI Agent │ │ 摄像头/GPS │
│ (你的助手) │ │ 文件系统 │
└─────────────┘ │ 通知栏 │
└──────────────┘
🔒 安全机制
- 端到端加密：所有通信通过 TLS 加密
- 权限控制：每个操作需要用户明确授权
- 配对验证：设备配对需要一次性验证码
- 操作日志：所有远程操作都有完整日志
3. 手机配对教程
📱 iOS / Android 配对步骤
# 步骤 1: 在 OpenClaw Gateway 启用 Node Connect
openclaw gateway config set nodes.enabled true
# 步骤 2: 手机安装 OpenClaw Node App
# iOS: App Store 搜索 "OpenClaw Node"
# Android: Play Store 搜索 "OpenClaw Node"
# 步骤 3: 扫码配对
# 在 App 中扫描 Gateway 显示的二维码
# 步骤 4: 验证配对
openclaw nodes status
# 输出: ✅ iPhone-15 (connected, last seen: 2s ago)
# 步骤 5: 测试连接
openclaw nodes camera_snap --node iPhone-15 --facing back
⚠️ 首次配对注意：
- 手机和 Gateway 需要在同一网络，或手机有公网可达地址
- iOS 需要在设置中授予摄像头、位置、通知权限
- Android 需要关闭电池优化，防止后台被杀
4. 远程拍照与视频
📸 拍照
# 用后摄像头拍照（默认）
nodes camera_snap --node "iPhone-15" --facing back
# 用前摄像头拍照
nodes camera_snap --node "iPhone-15" --facing front
# 前后摄像头同时拍照
nodes camera_snap --node "iPhone-15" --facing both
# 指定质量
nodes camera_snap --node "iPhone-15" --quality high
🎥 视频录制
# 录制 10 秒后置视频
nodes camera_clip --node "iPhone-15" --facing back --duration 10s
# 录制前置视频
nodes camera_clip --node "iPhone-15" --facing front --duration 30s
💡 实战技巧：结合 cron 定时任务，可以实现"每小时自动拍照"的监控功能。比如监控办公室绿植生长、记录工作桌面变化等。
5. 屏幕录制与截图
# 录制屏幕 30 秒
nodes screen_record --node "iPhone-15" --duration 30s
# 指定屏幕索引（多显示器场景）
nodes screen_record --node "MacBook" --screenIndex 0 --duration 60s
# 包含音频
nodes screen_record --node "iPhone-15" --duration 30s --includeAudio true
6. 文件传输
📥 从手机获取文件
# 浏览手机目录
dir_list --node "iPhone-15" --path "/DCIM"
# 获取文件
file_fetch --node "iPhone-15" --path "/DCIM/photo.jpg"
# 获取整个目录（tar.gz）
dir_fetch --node "iPhone-15" --path "/Documents/notes"
📤 传输文件到手机
# 写入文件到手机
file_write --node "iPhone-15" \
--path "/Downloads/report.pdf" \
--contentBase64 "base64编码内容" \
--overwrite true
7. 位置与通知
📍 获取位置
# 获取精确位置
nodes location_get --node "iPhone-15" --desiredAccuracy precise
# 获取粗略位置（省电）
nodes location_get --node "iPhone-15" --desiredAccuracy coarse
🔔 通知管理
# 列出最近通知
nodes notifications_list --node "iPhone-15" --limit 20
# 打开某个通知
nodes notifications_action --node "iPhone-15" \
--notificationKey "msg_123" --action open
# 关闭通知
nodes notifications_action --node "iPhone-15" \
--notificationKey "msg_123" --action dismiss
8. 实战场景
| 场景 | 实现方式 | 工具组合 |
|---|
| 🏠 远程家庭监控 | cron 定时拍照 + 飞书通知 | camera_snap + cron + message |
| 📦 快递到了通知 | 通知监听 + 智能回复 | notifications_list + AI 判断 |
| 📍 家人位置关心 | 定时获取位置 + 到家通知 | location_get + cron |
| 📸 自动生成日报 | 拍照 + AI 描述 + 文档生成 | camera_snap + feishu_create_doc |
| 📁 自动备份 | 定时同步手机照片到服务器 | dir_fetch + cron |
| 🖥️ 远程技术支持 | 屏幕录制 + AI 分析问题 | screen_record + AI 分析 |
9. 安全与隐私
⚠️ 安全最佳实践
- 最小权限原则：只开启必要的权限（拍照不需要位置权限）
- 操作确认：敏感操作（如文件删除）需要用户确认
- 访问日志：定期检查 Node 访问日志
- 网络隔离：Node 通信走独立加密通道
- 配对管理：不再使用的设备及时解除配对
🚀 让你的 AI Agent 连接物理世界
Node Connect 是 OpenClaw 最独特的功能之一，让你的 AI 助手不再只是文字
探索妙趣AI →