放置与机器选择
选择会话运行的机器:明确授权的配对设备、适用于任一执行框架的 Crabbox 云配置,以及按部署位置的操作系统和机器类别覆盖。
部署必需的 OpenClaw 目标¶
操作员可以设置
cloudWorkers.requiredProfile
当每个会话都必须使用一个 OpenClaw worker 配置时。Control UI 显示该目标时不提供选择器;它不是用户选择的云 worker。Gateway 拥有部署控制权,包括为没有仓库的聊天提供空的管理工作区,并拒绝选择本地或其他执行目标的尝试。普通用户不需要手动 dispatch 权限。
如果准备失败,初始消息将保持未发送状态,现有的部署恢复流程会提供 Retry 或 Stop。没有本地回退。以下可选选择流程适用于 Gateway 没有必需配置的情况。
配对设备上的 Codex¶
配对设备上的 Codex 部署要求在 Gateway 配置和节点自身本地配置中都安装并启用 codex 插件。当某台机器使用插件允许列表时,在该机器的 plugins.allow 中包含 codex。它还要求一个已连接且支持会话的节点,该节点通告 codex.exec-server,并且为 codex.exec-server.stdio.v1 提供显式的 gateway.nodes.commands.allow 条目。如有需要,批准节点更新后的配对界面。每次启动 exec-server 之前,OpenClaw 还要求正常的节点调用批准;拒绝该请求不会启动进程。
Codex 直接启动其 exec-server,因此配对设备和云节点部署不会占用 OpenClaw worker 槽位,并且在这些槽位已满时仍然符合条件。OpenClaw worker-turn 部署仍然需要一个可用的 worker 槽位。
批准允许在节点操作系统账户允许的任何位置执行进程和访问文件系统。精确的部署工作区控制起始目录和已协调的更改,而不是操作系统级别的限制。信任配对设备,并在需要隔离时使用单独的最低权限操作系统账户。
在 Control UI 的 Place 选择器中选择设备,或使用已授权的操作员连接 dispatch 一个 managed-worktree 会话:
openclaw gateway call sessions.dispatch \
--timeout 1500000 \
--params '{"key":"agent:main:device-work","deviceId":"<paired-device-id>"}'
Codex app-server、模型连接、提供商凭据和转录记录保留在 Gateway 上。配对节点在传输的工作区中运行受管理的 Codex exec-server,并通过现有节点通道仅接收经过脱敏的进程、文件系统、能力发现和 HTTP 操作。它不会启动 OpenClaw worker 子进程。携带凭据的 HTTP 请求在到达配对设备之前会被拒绝;请在 Gateway 上运行经过身份验证的请求,或使用有意不带凭据的端点。支持常规 Codex 回合,但 /btw 侧边问题尚未绑定部署位置,并且会明显失败。已完成的更改通过 worker 回合相同的部署工作区协调返回。有关确切的允许列表配置和生命周期,请参阅
在配对设备上运行 Codex。
云配置上的 Codex 或 OpenClaw¶
同一个已配置的 Crabbox 配置可以承载任一执行框架。在选择 OpenClaw 或 Codex 模型后,在 Cloud 下选择其配置行;所选运行时决定预配是准备 worker 子进程还是受管理的 Codex exec-server。Codex 云节点执行需要与配对设备执行相同的显式 Gateway 命令允许列表和部署范围批准。如果节点命令缺失、被拒绝或断开连接,它绝不会回退到 Gateway 本地或 SSH 执行。
对于云配置部署,等效的 RPC 流程如下:
创建一个仓库会话,dispatch 它,然后发送其第一条消息。配置 dispatch 需要 operator.admin,并且仅在至少配置了一个 worker 配置时可用:
openclaw gateway call sessions.create \
--params '{"key":"agent:main:big-refactor","repository":{"url":"https://github.com/example/project.git","ref":"main"}}'
openclaw gateway call sessions.dispatch \
--timeout 1500000 \
--params '{"key":"agent:main:big-refactor","profileId":"aws"}'
省略 ref 以使用仓库的远程默认分支。分支、标签或提交必须能够从该仓库获取。首次成功准备会固定确切的提交;后续 dispatch 会恢复该提交和已接受的检查点,即使分支移动。不要将 repository 与 cwd、projectId、projectGitUrl、worktree 或 worktree 命名选项组合使用,并且不要在此创建请求中包含初始消息。在激活部署之前发送会被拒绝,并给出 dispatch 指导。
若要保留现有的 Gateway 源流程,请改为使用 {"worktree":true,"cwd":"/path/to/repo","worktreeName":"big-refactor"} 创建。projectGitUrl 仍然表示 Gateway 管理的项目克隆。
仓库准备在符合条件的云分配之前固定不可变的源元数据,而不会创建受管理的 Gateway 检出。选择已准备好的容量并将其绑定到会话会验证当前访问权限和可见性,包括中断的预配在 Gateway 重启后恢复时。公共和私有准备身份保持分离。私有准备在 Gateway 上使用经过身份验证的临时 Git 对象,并且仅将经过验证的 pack 传输到 worker。已激活的会话在重启后保留其检出和已保存的更改;当 GitHub 访问权限发生变化时,这不会重新接纳已准备好的容量或撤销已下载的文件。没有项目准备的提供商在注册后保留普通检出。公共源仅在没有配置共享或原生 GitHub 身份时才能使用匿名访问;不可用的已配置身份仍会报错。
仓库准备和预置检出采用不会将 GitHub 凭据转移到 worker。后续 OpenClaw worker 轮次会在可用时,通过现有的每轮凭据绑定使用有效的共享或原生 GitHub 身份。
私有仓库获取使用有效的共享 tools.github 身份。通过 Control UI 仓库选择器访问本身不会授权该 worker 身份,并且个人发布凭据绝不会用于检出。
仓库设置使用节点上现有的可执行 .openclaw/worktree-setup.sh 约定。仅当创建时以管理员身份请求了设置,并且当前分发调用者也是管理员时,它才会运行。如果初始设置被中断,除非节点证明已接受的设置已经完成,否则需要管理员重试分发。预置采用和检查点恢复不会重新运行设置。没有可用于复制 .worktreeinclude 文件的本地源。
选择器中的提供商身份¶
云配置文件行和选中的 Place 标签会显示已配置的后端,包括 AWS、Azure、Daytona、Google Cloud 和 Hetzner。Machine0 和 Incus 使用服务器图标;本地容器使用方框;其他后端使用云图标。配置文件名称保持不变,并且即使配置文件名为 production,可访问性标签也会包含后端。重命名配置文件永远不会更改其提供商标识。
在“新建会话”和“移动”中,已识别的云提供商配置文件会显示在本地容器、Incus 基础设施以及自定义或未知后端之前。每个组仍按配置文件名称字母顺序排列。尽管 Machine0 使用服务器图标,它仍属于云提供商组;配置文件名称永远不会决定分组。Gateway 和配对设备部分保持其现有顺序。
在手机上,新建会话的环境和工作区控件垂直堆叠,并最多扩展到可用行宽度的 90%。较长的选中名称保持在一行内,并在末尾边缘淡出,而不是换行。操作系统和机器摘要位于环境名称下方,前面没有分隔符。桌面控件保持水平排列。
提供商可以通过其展示钩子提供此可选的只读身份。如果不可用,选择器会保留通用图标。显示 ID 不会更改路由、分配、权限,或操作系统和机器选择。
为每个会话选择操作系统和机器类别¶
worker 配置文件的 settings.target 和 settings.class 仍为其默认值;省略 Crabbox 目标表示 Linux。在 Control UI 的新建会话选择器中,将鼠标悬停在 云 下可配置的配置文件上或聚焦它,以打开其 操作系统 和 机器 选项。仅显示可用的操作系统。在选中配置文件之前,虚线轮廓会标识其默认值。选择任何选项都会选中该配置文件,并激活另一设置的默认值。机器列表会显示所选操作系统的类别,以及适用于所有系统的任何类别;在可用时显示报告的 vCPU 和 RAM,并标记默认值。更改操作系统时,如果所选类别对该系统不可用,则会清除该类别。
选中的配置文件行和关闭的选择器会在配置文件名称旁以弱化文本显示操作系统和机器,使用所选值或配置文件默认值。仅显示提供商报告的元数据。要通过 RPC 为一次新放置覆盖操作系统或大小,请随 profileId 传递 os 和/或 machineClass:
openclaw gateway call sessions.dispatch \
--timeout 1500000 \
--params '{"key":"agent:main:big-refactor","profileId":"aws","os":"linux","machineClass":"tiny"}'
当所选后端报告匹配目标时,捆绑的 Crabbox 提供商会列出 Linux、Windows(WSL2)、原生 Windows 和 macOS。在读取目录或启动 worker 之前,插件会解析受支持的 Crabbox 二进制文件,并在所选二进制文件过时或缺失时自动安装其受管副本。每个目标都使用相同的受支持版本;旧的本地 CLI 不再隐藏非 Linux 目标。有关受管安装策略,请参阅 Crabbox 配置。桌面支持 Linux、原生 Windows 和预置 macOS 镜像;不支持 WSL2 桌面。预热镜像仍仅限 Linux。请参阅 桌面先决条件。当目录包含可用的操作系统选项时,会显示 操作系统 部分;Crabbox 会报告可用目标,并且每个 Crabbox 机器选项都会标识其 os。
选择 windows/normal 表示原生 Windows,选择 windows/wsl2 表示 Windows 内部的 Linux 环境。原生 Windows 会以 PowerShell 运行 settings.setup,并要求来宾上具有受支持的 Node.js 和 npm。无头 Windows worker 还需要 Crabbox 的分离进程启动器。Bash 设置配方不能原样复用于该目标;请参阅 Worker 设置和捆绑安装。
选择器会提供提供商报告的类别以及已配置的默认值,即使 该默认值不在目录中。它会独立显示报告的 vCPU 和 RAM;缺失或不受支持的维度保持未知,包括在 可选的 macOS 类别上。它绝不会根据原生类型名称猜测硬件。 不可用或无法使用的目录元数据会隐藏机器选择器,但 配置文件仍可选择:在不覆盖的情况下分发或移动会保留其 配置。请参阅 Crabbox 机器目录 了解目录过滤、限制和维度格式。
成功的目录(包括有效的空目录)会在 Gateway 生命周期内缓存。失败的检查会由下一次发现请求重试;恢复时无需重启 Gateway。
映射的 Machine0 类即使在 Crabbox 省略旧版 classes 摘要时也会出现。这些静态映射描述的是类选择,而不是当前容量或可用性。OpenClaw 不会将提供商原生规格目录转换为类。请在 Crabbox 的配置中保留原生规格选择:显式配置的原生规格仍优先于类,因此选择器无法覆盖该固定值,也无法承诺可调整大小。通过 machineClass 接受原生服务器类型是后端特定的,并非通用的 Crabbox 契约。已接受的机器选择对该放置保持固定,并会被配置重试复用;目录变更不会重写它。os 和 machineClass 仅与 profileId 一起有效,而不是 deviceId 或 autoDevice。省略任一字段将使用相应配置文件的默认值。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw