📱 OpenClaw 移动节点完全指南

世界上有一种自由，叫做躺在沙发上用手机控制电脑上的AI Agent...

这篇文章教你把iOS或Android手机变成OpenClaw的远程控制终端，解锁Canvas、相机、语音等移动端专属能力。

什么是移动节点？

移动节点（Mobile Node）是OpenClaw的配套App，运行在你的iOS或Android设备上。它让你能够：

📱 Canvas展示 - 在手机上查看AI生成的界面、图表、网页
📷 相机调用 - 让AI"看见"你的世界
🎤 语音唤醒 - 说话控制AI，解放双手
🔔 推送通知 - 接收AI任务的完成提醒
📍 位置服务 - 基于位置触发自动化

准备工作

要求	说明
Gateway运行中	OpenClaw Gateway需要正常运行并监听网络端口
网络可达	手机和Gateway在同一局域网，或通过Tailscale连接
配对码	从Gateway生成配对码用于绑定

配对流程

步骤1：生成配对码

在Gateway所在机器上运行：

# 生成配对码
openclaw nodes pairing

# 输出示例：
# Pairing code: ABCD-EFGH-IJKL
# Valid for: 5 minutes
# Gateway URL: http://192.168.1.100:18789

步骤2：安装App

下载OpenClaw移动App：

iOS: App Store搜索"OpenClaw"或从这里下载
Android: Google Play或从GitHub Releases下载APK

步骤3：输入配对码

打开App，输入步骤1生成的配对码，App会自动发现Gateway并完成绑定。

# 成功配对后显示：
✅ Node paired successfully
Node ID: node-abc123
Gateway: 192.168.1.100:18789

步骤4：验证连接

# 在Gateway上查看已配对的节点
openclaw nodes list

# 输出：
# NODE ID       PLATFORM  STATUS    LAST SEEN
# node-abc123   ios       online    2 seconds ago

Canvas远程控制

Canvas是OpenClaw的可视化能力，让Agent生成的界面直接展示在你的手机上。

展示Canvas

// 在对话中请求展示Canvas
"帮我在手机上展示一个数据分析面板"

Agent会调用canvas工具：

{
  "action": "present",
  "url": "https://example.com/dashboard",
  "node": "node-abc123"
}

Canvas交互

// 截图当前Canvas
openclaw canvas snapshot --node node-abc123

// 在Canvas上执行JavaScript
openclaw canvas eval --node node-abc123 --script "document.title"

相机调用

让AI"看见"现实世界，实现视觉识别、OCR、场景理解等功能。

拍照

// 通过对话触发
"用我的手机拍张照，看看桌上是什么"

// 或直接调用API
{
  "action": "camera_snap",
  "node": "node-abc123",
  "facing": "back"  // front 或 back
}

使用场景

文档扫描 - 拍照OCR识别文字
物体识别 - AI识别物品、植物、动物
代码识别 - 拍代码让AI分析bug
环境感知 - 让AI了解你的 surroundings

语音唤醒

像用智能音箱一样控制你的AI Agent。

配置语音唤醒

{
  "nodes": {
    "voiceWake": {
      "enabled": true,
      "wakeWord": "hey openclaw",
      "sensitivity": 0.7,
      "language": "zh-CN"
    }
  }
}

使用方式

打开App，确保语音唤醒已启用
说"Hey OpenClaw"（或自定义唤醒词）
等待提示音，然后说出指令
AI处理并回复

💡 提示

语音唤醒需要App在前台运行，后台运行会消耗更多电量。建议在充电或长时间使用时开启。

推送通知

发送通知

{
  "action": "notify",
  "node": "node-abc123",
  "title": "任务完成",
  "body": "你的数据分析报告已生成",
  "priority": "active",
  "sound": "default"
}

通知类型

优先级	行为
passive	静默通知，不发出声音
active	正常通知，有声音和横幅
timeSensitive	时效性通知，可突破勿扰模式

位置服务

// 获取当前位置
{
  "action": "location_get",
  "node": "node-abc123",
  "desiredAccuracy": "balanced"  // coarse, balanced, precise
}

基于位置的自动化

// 示例：到家自动开灯
{
  "name": "home-automation",
  "schedule": {
    "kind": "event",
    "trigger": "location_enter",
    "geofence": {
      "lat": 31.2304,
      "lng": 121.4737,
      "radius": 100
    }
  },
  "action": {
    "type": "smart_home",
    "command": "turn_on_lights"
  }
}

屏幕录制

{
  "action": "screen_record",
  "node": "node-abc123",
  "durationMs": 30000,
  "includeAudio": true,
  "fps": 30
}

⚠️ 隐私提示

屏幕录制涉及敏感信息，建议：

仅在可信网络环境中使用
录制前通知用户
录制定时清理，不长期存储

常见问题

配对失败

检查手机和Gateway是否在同一网络
确认配对码未过期（默认5分钟）
检查防火墙是否允许18789端口

Canvas无法展示

确保URL可从手机访问
如果是本地服务，考虑使用Tailscale
检查HTTPS证书是否有效

相机/语音不可用

检查App是否有相机/麦克风权限
iOS需要在系统设置中授权
Android需要在App设置中授权

🎓 小结

移动节点让你的手机成为AI Agent的延伸：

配对很简单：生成码 → 输入App → 完成
Canvas让AI界面直达手机
相机和语音解锁更多交互方式
位置服务开启场景化自动化

在0和1之间，你的手机是最美的桥梁。