分发 cloud session

授权会话如何到达云目标，Control UI 在提供云目标之前需要什么，以及哪些运行时可以使用它。

会话调度¶

管理员可以在已配置的云配置文件上运行授权会话，包括没有仓库的全新工作区。在放置生命周期变更提交之前，会重新验证会话所有权和参与检查。

在 Control UI 中，打开 新建会话，然后选择 云 目标。当以下资格门槛全部通过时，云目标才可用：

1. 已连接的操作员具有 operator.admin 作用域。
2. environments.list 声明至少一个已配置的配置文件。
3. 所选智能体运行时声明支持云放置。

如果没有显式选择文件夹、项目或工作树，远程会话默认使用 新工作区：一个空的、隔离的工作目录。你也可以从项目选择器中选择 新工作区。不需要仓库、初始提交或 Gateway 文件夹。OpenClaw 会为每个全新会话使用一个私有后端仓库，以便工作区快照、恢复和清理保持正常行为；会话之间不共享 Git 远程或历史记录。现有本地文件不会被复制到新工作区。

选择仓库后，分支选择器会显示 来自 main（或所选分支）；在选中引用之前，它会显示 起始分支。选择 GitHub 仓库后，你可以选择源引用，而无需在 Gateway 上克隆。选择 Gateway 文件夹后，云选择会启用其受管工作树，并且仍要求该文件夹是可用的 Git 检出。在 Git 发现尚未完成时，选择目标不会丢弃显式源；请选择 新工作区 以改为从空目录开始。Gateway 会创建会话、完成调度，然后才发送第一轮消息。会话侧边栏中的服务器徽章显示持久化放置状态。启动恢复会保留工作区选择、目标和第一条消息。

如果 Gateway 在预置期间重启，挂起的第一条消息会等待恢复，并在其工作器就绪后自动继续。临时启动或暂停错误不会取消设置。第一条消息会保留在聊天中后续恢复通知之前，包括重新连接后也是如此。

如果启动恢复超时，通知会区分仍在进行中的设置与无法确认完成的 Gateway，并确认第一条消息尚未发送。重试 会先检查现有工作器。它会等待已经进行中的设置，并在该工作器就绪后发送保留的第一条消息。仅当放置允许新的调度时，才会请求替换；仍需要清理的失败工作器必须首先被停止。仅重新连接永远不会请求替换。

在新会话仍在预置时选择 停止云工作器… 会在请求拆除之前暂停其初始消息。迟到的调度响应无法发送该消息。草稿保持可见，供 重试 使用，并且不会自动重新提交。常规会话草稿在重新连接和页面重新加载后仍然保留；隐身草稿仅保留在当前页面。如果第一条消息已经发送，但送达情况不确定，则应使用 检查送达情况，而不是开始另一轮。

当放置处于活动状态时，OpenClaw 会自动采样远程工作区卷上的可用空间。低空间警告会出现在所选聊天和会话的云徽章上。这些警告仅供参考，空间恢复后会自动清除，不会停止或回收工作器。

云子会话¶

当 OpenClaw 工作器使用 sessions_spawn 时，Gateway 会在单独的受管工作树中创建可见的子会话，使用父会话的配置文件预置一个工作器，并在返回接受之前提交初始任务。该调用不会等待子任务完成。

在该调用等待期间，父会话在现有运行超时时间内仍是一个活动轮次。仅靠静默预置不会让排队消息接管父会话，也不会让恢复提前中止它。工作器进度不会延长超时时间，聊天中的 停止 控件或 /stop 仍可取消该轮次。请另行使用 停止云工作器… 来协调工作区并释放机器。

运行时支持¶

• OpenClaw 使用 worker-turn 放置。受限的 openclaw worker 进程在租用节点上运行每个轮次，并通过 Gateway 代理推理。
• Codex 使用 remote-exec 放置，适用于同一个捆绑的 Crabbox 云配置文件、符合条件的配对设备，或声明提供基于 SSH 的执行载体的提供商。Gateway 将 Codex app-server 和身份验证保留在本地；已注册的云节点仅运行明确授权的 Codex exec-server，不会启动 OpenClaw 工作器子进程。

Control UI 会在“新建会话”和“移动会话”中检查每个云目标声明的执行模式。一个 Crabbox 云 · 配置文件 行对 OpenClaw 和 Codex 均可选择，而真正单模式的提供商会针对另一种运行时保持禁用。不兼容的移动会在活动源开始排空或更改其持久化放置之前被拒绝。

其他运行时仍然不可用，除非其 harness 显式声明云放置模式。云目标不会提供给外部 CLI 会话目录。如果所选提供商或放置沙箱不可用，remote-exec 会安全失败；它绝不会回退到在 Gateway 主机上运行该操作。