多设备使用 OpenClaw：会话同步与权限分层
本文是面向多设备使用者的原创指南。事实依据来自本站远程访问、沙箱、工具策略与提权、自动化负载与执行审批等页（对照 2026-11-06 固定官方快照核对），不引入新的外部断言；示例为说明性、未实机运行。
家里跑着一台 OpenClaw Gateway，人在沙发上用手机、在书房用笔记本、出门用平板——这件事的关键认知只有一个：会话、凭据、渠道与状态全部住在 Gateway 上，每个设备都只是客户端。理解了这一点，“谁在哪个设备能看到什么"“换设备怎么接上"“设备丢了怎么办"就都有了明确答案。
一、先分清两类客户端
连到 Gateway 的设备分两类，能力与信任完全不同：
| 类型 | 是什么 | 能做什么 |
|---|---|---|
| 操作员客户端 | 你本人使用的 macOS 应用、CLI、Web 界面 | 完整操作：聊天、管理配置、审批执行、管理任务 |
| 节点（node） | iOS/Android 等设备上的节点客户端 | 作为外围设备：向 Gateway 暴露本机能力（如节点工具调用），不拥有会话也不运行 Gateway 服务 |
节点不运行 Gateway、不存储会话；它把自己的能力注册给 Gateway，由 Gateway 的智能体决定是否调用（例如"用手机拍张照"这类节点工具）。macOS 应用的"节点模式"本质上也就是一个经 WebSocket 连接的节点客户端。
二、会话如何在设备间接续
因为会话由 Gateway 拥有，“换设备"不是同步问题而是附着问题：
- 任何已认证的操作员客户端连上 Gateway 后，看到的是同一份会话列表与历史；
- 远程客户端可以通过 URL 或短引用继续同一 Gateway 拥有的会话——在手机上开的话题，回笔记本输入同一会话引用即可接上；
- 消息发往会话而非发往设备：给任务的
cron:<jobId>会话发消息寻址其最新运行，与你当前用哪台设备无关； - 设备离线不中断任何会话——Gateway 常开，会话随 Gateway 存续。
推论：不需要也不会有"设备间聊天记录同步"这种操作；要备份的是 Gateway 的状态（见家庭服务器运行 OpenClaw的备份节）。
三、权限分四层，每层管不同的事
多设备场景的"谁能做什么"是四层的叠加（分层方式为本文作者组织，各层语义来自官方文档）：
- 网络可达层：设备能否建立连接——loopback/局域网/tailnet/公网的暴露范围选择，见从外部安全访问家里的 OpenClaw。可达不等于任何权限。
- Gateway 认证层：token / password / Tailscale 身份 header（仅 Control UI 与 WebSocket，HTTP API 走正常认证）。每个操作员客户端凭凭据连接；客户端对 SSH 目标缓存配对设备凭据，其作用域绑定"该 SSH 目标+远程 Gateway 端口”，与本地端口号无关。
- 会话与工具策略层：连上之后能调用什么工具、是否沙箱——
tools.*工具策略、agents.*.sandbox、会话权限模式与操作员角色（operator scopes，含强制沙箱这类不可被提权绕过的策略）。 - 审批层：主机执行前的 exec 审批（allowlist/ask/常设授权），审批卡投递到已连接的审批界面，任何操作员设备都能回应。
多人或多用途隔离：不同家庭成员或不同用途可用不同智能体（agents.entries.*）——每个智能体有独立的工具允许列表、沙箱与配置；自动化任务还有各自的账户绑定与工具上限。一台 Gateway 可以同时承载"全家共用的助手"和"你的工作智能体"而互不越界。
四、设备接入路径（按设备类型）
笔记本/桌面（操作员）：
- 局域网内：直连
ws://<gateway-ip>:18789（需 Gateway 绑定+认证）； - 外网：SSH 隧道或 Tailscale（推荐，见远程访问指南）；macOS 应用用远程模式自动管理传输（含常驻隧道的 LaunchAgent 方案，见远程访问参考页）。
手机/平板（节点或轻客户端）：
- 作为节点：在应用中连接 Gateway 地址并完成配对——配对即把该设备注册为这台 Gateway 的节点；
- 作为操作员（手机浏览器/应用远程模式）：走与笔记本相同的认证链路。
检查顺序（说明性示例）：①设备能到 Gateway 吗（curl http://<地址>:18789）→ ②认证过了吗（带 token 的 openclaw gateway status --url … --token …）→ ③会话列表出现了吗 → ④节点能力注册了吗（openclaw nodes 相关状态）。
五、设备丢失或换机怎么办
- 吊销设备访问：删除/重置该设备的配对与缓存的设备凭据（配对凭据按 SSH 目标与端口分作用域，换机不等于旧凭据失效——主动清理）；
- 轮换 Gateway token/password：怀疑凭据泄露时整体轮换，所有设备用新凭据重新连接；
- 审计：
openclaw logs与运行历史可回看该设备凭据下发生过什么； - 节点侧：移除节点注册即可断开其能力暴露；节点本身不持有会话数据，丢失节点设备的风险面=它的配对身份。
与其他页面的分工
- 拓扑选择与隧道配置：从外部安全访问家里的 OpenClaw
- 认证机制全量（token/password/trusted-proxy/凭据优先级）：远程访问参考页与认证
- 工具策略/沙箱/提权：沙箱、工具策略与提权
- 执行审批与设备审批面：执行审批