审批和沙箱
Codex 回合的审批与沙箱姿态,以及原生执行在何处运行。属于 Codex harness 参考;各章节迁移位置 列出了每个章节。
对于原生插件/应用工具,还请遵循 应用审批决策顺序。应用准入、工具启用、按工具的审批模式,以及 OpenClaw 的引导响应,均独立于下面的一般预设。
审批与沙箱模式¶
本地 stdio 应用服务器会话默认采用 YOLO 模式:approvalPolicy: "never"、approvalsReviewer: "user" 和 sandbox: "danger-full-access"。这种可信的本地操作员姿态允许无人值守的 OpenClaw 回合和心跳在没有人应答原生审批提示的情况下继续推进。
如果 Codex 的本地系统 requirements 文件不允许隐式的 YOLO 审批值、审批者值或沙箱值,OpenClaw 会转而将该隐式默认值视为 guardian 模式,并选择允许的 guardian 权限。tools.exec.mode: "auto" 还会强制使用 guardian 审查的 Codex 审批,并且不会保留不安全的旧版 approvalPolicy: "never" 或 sandbox: "danger-full-access" 覆盖配置;如需有意的无审批姿态,请设置 tools.exec.mode: "full"。同一 requirements 文件中匹配主机名的 [[remote_sandbox_config]] 条目在沙箱默认决策中会被采纳。
设置 appServer.mode: "guardian" 以启用 Codex guardian 审查的审批:
{
plugins: {
entries: {
codex: {
enabled: true,
config: {
appServer: {
mode: "guardian",
serviceTier: "priority",
},
},
},
},
},
}
当这些值被允许时,guardian 预设会展开为 approvalPolicy: "on-request"、approvalsReviewer: "auto_review" 和 sandbox: "workspace-write"。各个策略字段会覆盖 mode。较旧的 guardian_subagent 审批者值仍作为兼容别名被接受,但新配置应使用 auto_review。
当 OpenClaw 沙箱处于活动状态时,本地 Codex 应用服务器进程仍在 Gateway 主机上运行。因此,OpenClaw 会在该回合中禁用 Codex 原生 Code Mode、用户 MCP 服务器和应用支持的插件执行,而不是将 Codex 主机端沙箱视为等同于 OpenClaw 沙箱后端。当常规 exec/process 工具可用时,Shell 访问将通过 OpenClaw 沙箱支持的动态工具(如 sandbox_exec 和 sandbox_process)暴露。
Note
在 Docker 支持的 OpenClaw 沙箱主机上(agents.defaults.sandbox.mode 设置为
Docker 后端),独立的 openclaw doctor 会使用 unshare 检查用户命名空间。
这些 Codex bwrap 检查在 openclaw update 期间会被省略;请在更新后运行
openclaw doctor。
当 Docker 沙箱网络出站流量被禁用且配置了本地 Codex 运行时,
它还会以网络访问已禁用的方式运行所配置 Codex 二进制文件自身的 workspace-write
沙箱,从而测试 Bubblewrap 的 loopback 设置。
无法识别的检查失败会被报告为 unverified(未验证),而不是命名空间诊断。
命名空间失败通常表现为
bwrap: setting up uid map: Permission denied 或
bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted,
常见于 Ubuntu/AppArmor 主机。请为 OpenClaw 服务用户修复所报告的
主机命名空间策略,并重启 gateway;对于服务进程,优先使用限定作用域的
AppArmor 配置文件,而不是主机级的
kernel.apparmor_restrict_unprivileged_userns=0 回退方案,也不要为了
满足嵌套的 bwrap 而授予更广泛的 Docker 容器特权。
沙箱化原生执行¶
稳定的默认行为是失败关闭(fail-closed):处于活动状态的 OpenClaw 沙箱会禁用原本会从 Codex 应用服务器主机运行的原生 Codex 执行表面。仅当你希望通过 OpenClaw 的沙箱后端尝试 Codex 的远程环境支持时,才使用 appServer.experimental.sandboxExecServer: true。此预览路径使用固定版本的 Codex 0.160.0 应用服务器。
{
plugins: {
entries: {
codex: {
enabled: true,
config: {
appServer: {
experimental: {
sandboxExecServer: true,
},
},
},
},
},
},
}
当该标志开启且当前 OpenClaw 会话处于沙箱中时,OpenClaw 会启动一个由活动沙箱支持的本地 loopback exec-server,将其注册到 Codex 应用服务器,并使用该 OpenClaw 拥有的环境启动 Codex 线程和回合。如果应用服务器无法注册该环境,运行将失败关闭,而不是静默回退到主机执行。
沙箱化进程的输出会以有序的 stdout、stderr 或 PTY 通知形式流式传输。OpenClaw 仅保留有界的近期输出缓冲区用于轮询和重放,因此长时间运行的进程无法无限制地增大应用服务器桥接。进程退出和清理仍与沙箱拥有的进程绑定。
此预览路径仅限本地。远程 WebSocket 应用服务器无法访问 loopback exec-server,除非它运行在同一主机上,因此 OpenClaw 会拒绝这种组合。
在配对设备或已注册的 Crabbox 云工作器上进行的基于节点的 remote-exec 放置(placement),是一条独立的、由该放置拥有的执行路径,不需要 appServer.experimental.sandboxExecServer。Gateway 将 Codex 应用服务器和提供商认证保留在本地,而经授权的节点在其现有双工连接上运行受管理且固定版本的 Codex exec-server。它需要对 codex.exec-server.stdio.v1(已批准的配对面)进行显式的 gateway.nodes.commands.allow 授权,并对每次尝试进行启动授权。
只有当前已准入的回合和放置仍然有效,并且节点本地的 tools.exec 和 exec-approvals 底线都允许 full/off 执行时,特意选择的会话 Full access 权限才可以替代关键的 allow-once 提示。普通调用者和原始调用者仍需要人工审批。本地 deny 会阻止任一启动;本地的 ask 和 allowlist 策略无法通过 Full access 绕过。设置期间更改的本地策略会拒绝该启动。Gateway 和节点必须都支持此授权路径;缺少节点策略支持则失败关闭。
节点会获得全新的私有主目录和经过净化的环境,绝不会获得 Gateway 提供商、云或 GitHub 的凭据。节点连接丢失会终止尝试和进程,而不是恢复它。每次基于节点的尝试都使用自己的 Gateway 应用服务器客户端,因为 Codex 可以注册远程环境,但无法从正在运行的应用服务器中移除环境。节点 exec-server 不会占用 OpenClaw 工作器槽位。包含认证、cookie、API 密钥或其他携带凭据头部的 HTTP 请求会在到达节点之前被拒绝;请改用 Gateway 拥有的经过认证的请求或无凭据端点。
支持正常的 Codex 回合,但在 /btw 辅助问题可绑定到活动放置之前,它们不可用。
受管理的放置工作区不是操作系统沙箱:已批准的进程和文件拥有节点账户的完全访问权限。当需要隔离时,请使用单独的最小权限节点账户。
参见 在配对设备上运行 Codex 和 在云工作器上运行 Codex。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw