跳转至

远程放置

Codex 会话如何将原生执行放置在网关之外,同时应用服务器、模型连接和会话记录仍归网关所有。属于 Codex harness 指南的一部分;各章节去向 列出了每个章节。

在配对设备上运行 Codex

Codex 会话可以将原生命令、文件系统、能力发现和 HTTP 执行放置在符合条件的配对设备上,而 Codex 应用服务器、模型推理、提供商身份验证和会话记录仍保留在网关上。这是会话级 remote-exec 放置,而非 node_exec 或 tools.exec.host: "node"。

在网关的配置和配对节点自身的本地配置中都安装并启用 Codex 插件。如果任一机器使用 plugins.allow,请将 codex 包含在该机器的允许列表中。在网关上,显式允许高风险节点命令:

{
  gateway: {
    nodes: {
      commands: {
        allow: ["codex.exec-server.stdio.v1"],
      },
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

配对节点必须启用会话托管,并公布 codex.exec-server 能力和 codex.exec-server.stdio.v1 命令。如果启用插件改变了现有节点的命令表面,请重新连接节点,检查 openclaw nodes pending,并使用 openclaw nodes approve <requestId> 批准更新后的配对。持久命令允许列表不能替代启动授权。关键提示提供两种批准范围:

  • 允许一次 授权一次 exec-server 启动。
  • 始终允许 仅在同一节点、配对代次、环境、所有者代次、放置代次、命令风险和相同工作目录下该确切会话放置仍处于活动状态时,授权后续启动。

网关仅在其当前进程中保留常驻放置授权,并在每次节点传输分发前立即重新验证。因此,重启网关会回到正常提示,而不会迁移或重新加载批准状态。移动或回收会话、替换环境、在新配对下重新连接、更改工作区或达到 30 天最长生命周期也会使重用失效。如果网关无法推导出确切的放置权威,则仅提供允许一次。拒绝则不会启动任何进程。

如果启动批准过期或被拒绝,OpenClaw 会显示执行批准消息,并保持模型的认证配置文件健康。重试该操作并批准新请求以继续;重新登录无法解决启动拒绝问题。

显式选择的会话完全访问仅在确切允许的回合和放置期间,并且仅在节点自身的 tools.exec 策略和执行批准下限都允许 full/off 执行时,才能替代提示。节点本地拒绝始终阻止。本地询问或允许列表限制需要人工决策;完全访问不会消除这些限制。如果完全启动被本地策略拒绝,请使用普通会话权限模式请求批准,或有意更改节点的本地策略并重新连接它。启动准备期间策略收紧会拒绝过期的启动。

Codex 直接启动其节点 exec-server,而不是启动 OpenClaw 工作进程,因此即使所有工作进程槽位都已占用,配对主机仍保持合格。该命令必须仍然可以有效调用:仅声明它而没有批准的配对表面和网关允许列表是不够的。

批准授权访问节点操作系统账户可用的任何进程或文件。已验证的放置工作区设置工作目录和协调范围;它不会对那种访问进行沙箱隔离或限制。仅配对受信任的设备,并在需要隔离时以单独的最小权限操作系统账户运行节点。

在 Control UI 的 Place 选择器中选择配对设备,或显式调度现有托管工作树会话:

openclaw gateway call sessions.dispatch \
  --params '{"key":"agent:main:device-work","deviceId":"<paired-device-id>"}'

节点在放置工作区中使用 codex exec-server --listen stdio 启动相同的受管固定 Codex 二进制文件。节点会等待原生进程开始侦听后才宣布执行就绪,因此冷磁盘启动不会消耗 Codex 的初始化握手预算。启动仍可通过现有的尝试生命周期取消。网关通过现有的经身份验证、批准门控的双工节点通道中继完整的 Codex JSON-RPC 消息,每条消息限制为 64 MiB。它不会启动 OpenClaw 工作进程子进程、打开反向隧道,或将提供商、云或 GitHub 凭据复制到设备。经过身份验证的远程 HTTP 不可用:网关会在将包含 bearer/OAuth 授权、cookie、API 密钥或其他敏感身份验证头的请求发送到节点之前将其拒绝。在网关上运行经过身份验证的 HTTP,或使用有意免凭据的端点。节点进程使用全新的私有 HOME 和 CODEX_HOME,这些目录在尝试结束后被移除,并且其启动环境和请求的子进程环境均经过净化处理。已完成的文件系统更改会协调到网关所有的受管工作树中,或者对于仅仓库会话,协调到网关保留的不可变检查点中。

在 Codex 的默认环境策略下,原生任务进程会继承 exec-server 的启动 RUST_LOG 过滤器。当程序需要不同的日志级别时,请在命令中显式设置 RUST_LOG。

断开节点、关闭应用服务器连接、取消回合或停用插件都会明确结束该 Codex 尝试,并终止其远程 exec-server 进程。每次配对设备尝试都拥有一个隔离的网关应用服务器客户端,防止远程环境注册在多次尝试间累积。重新连接同一配对设备允许进行新的尝试;它永远不会恢复已断开的 stdio 连接或其进程。支持正常的 Codex 回合,但 /btw 附带问题尚未绑定到配对设备放置,会因可操作的说明而失败。参见云工作进程和配对设备放置和节点命令策略。

在云工作节点上运行 Codex

捆绑的 Crabbox 提供商同时支持 OpenClaw worker-turn 和 Codex remote-exec,因此一个已配置的云工作节点配置文件可供任一框架选择。在选择 Codex 模型后,在 New Session 或 Move Session 中选择相同的 Cloud · profile 目标。放置配置文件需要 operator.admin。可以从 GitHub 仓库 URL 和可选 ref 开始,而无需 Gateway 检出,也可以放置现有 Gateway 管理的 worktree 会话。 仅仓库会话会在所选节点上获取并固定其源。 仓库会话需要受管节点;仅 SSH 提供商无法创建它们。

启用受信任的 Codex 插件安装,并在 Gateway 上显式允许 codex.exec-server.stdio.v1,如 在配对设备上运行 Codex 中所示。 Crabbox 会自动从正在运行的 Gateway 的内置安装引导云节点,包括 Codex 插件及其固定的原生依赖项。 引导会安装云机器操作系统和 CPU 所需的依赖项,然后在节点的隔离状态中启用该插件。请保持配置文件设置专注于机器先决条件和项目工具,包括受支持的 Node.js 版本和 npm。有关构建和注册表访问要求,请参阅 捆绑安装。

Gateway 会在启动 Codex 进程之前检查云节点当前的配对状态和 实际可调用命令。相同的放置范围审批或显式选择的 Full access 规则适用, 包括云节点的本地 exec 策略和审批下限。

Codex 通过已注册节点的经过身份验证的出站连接运行其受管 exec-server,而不会启动 OpenClaw worker 子进程或占用 worker 槽位。其 app-server、模型连接、提供商身份验证和 转录仍由 Gateway 拥有。进程和文件系统访问仍具有 节点操作系统账户的权限,并且仅转发无凭据的 HTTP。工作区更改会协调到 Gateway 拥有的 worktree 或不可变的仓库检查点。失败或断开连接的尝试是终态的, 需要新的尝试;它永远不会恢复远程进程,也不会回退 到 Gateway 本地或 SSH 执行。

有关配置文件设置、 放置生命周期和清理,请参阅 云工作节点。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw