让手机和电脑共用一个AI助手：openclaw多设备协同10分钟上手指南
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
openclaw 是一个跨平台的个人 AI 助手：桌面设备跑网关（Gateway），手机作为节点接入，聊天、记忆、指令全部共享。跟着这篇指南，你 10 分钟能把第一台桌面设备跑起来，再用各三步把 iOS 和 Android 接进同一个网络，并看懂设备之间到底怎么协作。
场景切入：一个人为什么需要多台设备
先对号入座，看你是否也有这些困扰：
- 工位上让助手跑任务，回家想接着聊——但会话留在公司电脑上，换设备就得从头再说一遍。openclaw 的会话存在网关侧，手机连上就能接着聊。
- 手机里拍的照片、位置的语音指令，想直接喂给 AI——把 iPhone/Android 配对成节点后，摄像头、屏幕、位置都成了助手的能力，一条消息就能调用。
- 人在外面，家里的机器替你执行——网关跑在家里，你通过手机随时下达指令，结果推回来。
macOS 首次运行时可能会弹出"本地网络"授权，允许它，否则手机在局域网里发现不了这台网关。
10分钟起步：把第一台桌面设备跑起来
前提：Node.js 22.22.3+（或 24.15+ / 25.9+），以及任意一家模型提供商的 API key。然后走最小路径：
git clone https://gitcode.com/GitHub_Trending/cl/openclaw cd openclaw npm install装完依赖后运行openclaw onboard，向导会依次让你选模型提供商、粘贴 API key、确认网关配置。跳过可选步骤没关系，之后随时可以再进配置。
openclaw onboard openclaw gateway status看到什么算成功：gateway status显示网关正在监听18789端口；再执行openclaw dashboard，浏览器打开控制台，发一句消息收到 AI 回复，桌面这台就算活了。
手机端三步接入：iOS 与 Android
两个平台的共同点：手机都是"节点"，不跑网关，只负责连接和提供能力（摄像头、屏幕、位置、语音）。
iOS 三步接入
- 确认网关对局域网可达——默认绑定回环地址，手机够不到；按需把
gateway.bind设为lan（字段在网关配置里），或启用 Tailscale serve 走远端。 - 打开 App 扫码配对——控制台切到 Nodes 页，点 Pair device 生成 setup code 二维码，iOS App 在 Settings → Gateway 里扫一下即可，同网段也会通过 Bonjour 自动发现网关。
- 在网关侧批准请求——扫码后会产生一条配对申请，在网关终端执行批准：
openclaw devices list openclaw devices approve <requestId>💡 待批准请求在设备最后一次重连后 5 分钟过期，设备反复重连时requestId可能刷新，批准前先重跑devices list确认最新 id。
Android 三步接入
- 安装官方 App——从 Google Play 装，或从 Release 里下载签名 APK 侧载（注意校验 SHA256）。
- 打开 App 指向网关——同局域网可走自动发现；发现不了就开 Manual Host，填网关的 IP 和端口 18789。
- 批准配对并验证——同样在网关侧
openclaw devices approve，然后：
openclaw nodes status openclaw nodes describe --node <idOrNameOrIp>看到节点在线、describe里列出 camera/location 等能力，安卓接入就算完成。
幕后机制：设备间到底怎么协作
三条线，各管一事：
- 节点发现：同局域网走 Bonjour 广播，手机 App 扫到网关后直连 18789 的 WebSocket；跨网络则靠 Tailscale 这类私有网提供路径，再不行就手填 host/port。
- 数据同步：会话和记忆以网关为权威源，各端拉取的是同一份状态，所以换设备"接着聊"不需要手动同步。iOS 端另有离线兜底——断网时最近会话有只读缓存，离线发出去的文字进持久队列（上限 50 条），重连后按顺序补发，离线超过 48 小时才过期。这就是"离线数据怎么同步"的答案：不丢，靠补发。
- 任务路由：消息统一落到网关，模型在网关侧跑，工具调用按能力分发。要"在某台设备上执行"的指令（如
system.run）会被转发给指定节点执行，也就是 node host 模式；摄像头、屏幕这类能力则只从持有该能力的节点取。
进阶调优：安全、省电与离线一张表
| 要改什么 | 怎么改 | 为什么 |
|---|---|---|
| 明文 ws:// 连接 | 改用wss://或openclaw gateway --port 18789 --tailscale serve | 局域网明文 bearer token 会被自动降权到受限访问，加密连接才能拿到完整管理权限 |
| 网关绑定范围 | 配置里gateway.bind从 loopback 改为lan | 默认只听本机，手机永远发现不了你 |
| 省电 | 不强制手机常驻前台；需要拍照/截屏功能时再打开 App | 移动系统会挂起后台连接，camera/screen 本来就只在前台可用，常驻没有收益 |
| 离线缓存 | 无需配置，iOS 队列默认 50 条/48 小时 | 弱网环境下消息先落盘、重连补发，避免丢失 |
⚠️ 改完加密或绑定配置要重启网关，已配对的设备在认证方式变化后可能需要重新扫码。
出错怎么办：自助排障表
| 现象 | 大概率原因 | 处理 |
|---|---|---|
| 手机发现不了网关 | bind 还是 loopback，或不在同一局域网 | 改gateway.bind: lan，确认两边同一网段 |
| 扫码后一直 Pending | 配对请求没批准，或已过期（最后重试后 5 分钟） | 重跑openclaw devices list拿最新 id 再 approve |
拍照/截屏报NODE_BACKGROUND_UNAVAILABLE | 相机和屏幕能力只在前台可用 | 把手机 App 切到前台重试 |
能力报*_PERMISSION_REQUIRED | 系统权限没给 | 在系统设置里给相机/录屏/定位授权 |
system.run被拒 | 节点侧执行审批没过 | openclaw approvals get --node <id>查看并补充允许列表 |
排障不确定时，先在网关上跑openclaw triage，它会做一轮只读体检并给出可执行的诊断结论。
多设备接入到这一步就算齐活了。更多细节看官方文档：docs/ 和节点专题 docs/nodes/。
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
