OpenClaw - Cloud Sessions
OpenClaw 官方文档：cloud session —— 会话照常出现在侧栏、流式进 chat，只是编码工作跑到另一台机器上执行。Gateway 始终拥有对话、reconciled workspace、模型凭据与 placement 记录；远端机器只负责命令、文件编辑与工具执行。核心设计原则一句话：placement 一次性、session 永久。
要点
- 三种目的地，同一套模型：Gateway（默认，日常会话）/ Paired device（自有硬件，
openclaw connect --service --session-host一条命令配对，按 CPU 核广播 worker slot，可选容器隔离）/ Cloud worker（经 Crabbox 按需租机，用完即拆，机上不留常驻凭据）。三者共用同一 session、同一 chat、同一个 Place picker；scope 分别为 —、operator.write、operator.admin。 - 故障语义：云机器消失 → 下一条消息自动换机；配对设备离线 → placement 保留等它回来；Continue on Gateway… 是显式动作，可能丢失未同步文件——唯一损失窗口是上次 reconcile 之后的改动，干净停机（含自动挂起）先 reconcile 再放机。
- 安全不变量：所有远端放置下模型推理都经 Gateway 代理，provider 凭据永不落到远端机器；完成的工作 reconcile 回 managed worktree。OpenClaw
worker-turn与 Codexremote-exec共用同一套目的地。 - 附件流水线：原始输入落
media/inbound/openclaw-staged-<id>/（本地 Git 排除；要求 producer 生成的目录名 + 完整.gitignoreownership marker，仅名字相似不被选中）。传输限额：25,000 文件 / 256 MiB 总量 / 单文件媒体读 6 MiB / 编码帧（launch、推理、带图 transcript）25 MiB，base64 计入。vision 模型走原生图片输入，纯文本模型只拿文件路径。turn 取消会中止附件流送且不再安装后续附件；文档如实记录fs-safe0.5.6 下残留的有限最终写入缺口及 TODO 修复计划。 - 闲置经济：
suspendAfter: "2h"空闲安全停机（只付快照存储费）；settings.warmImage在 node 注册前把 committed checkout + node runtime 拍成可复用镜像——匹配的 seed 跳过 origin 访问与 Git pack 传输，私有/未发布 commit 也适用。挂起绝不打断工作：活跃 turn、排队消息、未 reconcile 结果一律跳过待下轮。 - 桌面与 computer 控制：Desktop 面板与 agent 的
computer工具绑定同一台执行机器（需 Cloud Worker Desktop lab +settings.desktop: true），默认 view-only 起步；截图留 worker transcript，旧的处理过的图替换为文本标记以压 transport 限额。computer 控制绑定准入 turn/placement/连接/provider——worker 断连即关闭，重连后需新 turn。 - 自动负载均衡：Place picker 选 Auto 或
autoDevice: true，按最闲设备分配；worker-turn 放置按空闲 slot 排序（同分按设备 ID），remote-exec 不占 slot 故只按设备 ID；失败最多重试 3 台排序主机，无合格主机时报错说明具体原因。
值得留的原话
Placement is disposable; the session is not. The transcript, the last-reconciled workspace files, placement history, and every provider credential live with the Gateway in all placements.（“What stays with the Gateway” 一节）
model inference stays proxied through the Gateway — provider credentials never reach the remote machine（“三种目的地”表格后）
关联
- Agent 状态分层 的直接产品实例：Gateway 即权威 work 层（transcript/placement/凭据），远端机器即一次性 workspace/执行面。
- vs GitHub Codespaces：Codespaces 把”开发环境”整体搬云（持久容器、按月计费、面向人）；OpenClaw 把”agent 执行”搬云（一次性机器、面向 agent turn、Gateway 持有会话）。
- 实体页：OpenClaw。