调度云会话
已授权会话如何到达云目标、Control UI 在提供该目标前需要满足哪些条件,以及哪些运行时可以使用它。
分发会话¶
管理员可以在已配置的云配置档上运行已授权会话,包括没有仓库的新工作区。在放置生命周期变更提交之前,会重新验证会话所有权和参与检查。
在 Control UI 中,打开 新建会话 并选择 云 目标。当以下资格门槛通过时,云目标可用:
- 已连接的操作员具有
operator.admin范围。 environments.list通告至少一个已配置的配置档。- 所选代理运行时通告支持云放置。
如果没有明确选择文件夹、项目或工作树,远程会话默认使用 新工作区:一个空的、隔离的工作目录。你也可以从项目选择器中选择 新工作区。不需要仓库、初始提交或 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 选择,而真正单模式的提供商对另一个运行时保持禁用。不兼容的移动会在活动源开始排空或更改其持久化放置之前被拒绝。
除非其框架显式声明云放置模式,否则其他运行时仍不可用。外部 CLI 会话目录不提供云目标。如果所选提供商或放置沙箱不可用,Remote-exec 会失败关闭;它永远不会回退到在 Gateway 主机上运行该操作。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw