Code Mode 执行器
Code Mode 在启用时默认使用 Node。当你需要加固的访客运行时,请选择 QuickJS。两个执行器运行相同的纯 JavaScript 单元,暴露相同的类型化工具发现机制,并使用相同的 exec 和 wait 工具。在没有全局 Code Mode 设置的情况下,将采用按模型的自动激活。在 Labs 中选择执行器会保留激活状态。在 config 中编写对象时,包含 enabled: "auto" 以保留自动激活。
选择执行器¶
| 执行器 | 预期用途 | 执行方式 | 挂起状态 |
|---|---|---|---|
node(默认) |
在 Gateway 主机上的可信执行 | 工作线程中的 Node.js node:vm |
活动的工作线程和 JavaScript 上下文 |
quickjs |
加固的访客隔离 | 由捆绑执行器插件提供的工作线程中的 QuickJS-WASI | 序列化的 VM 快照 |
Warning
Node 的 node:vm 不是安全边界。工作线程将访客计算移出 Gateway 事件循环,但它共享 Gateway 进程的操作系统特权。请将 Node Code Mode 视为受信任的主机执行。
桥接结算和故障溯源在两种执行器下均由宿主拥有,因此无论执行器隔离如何,诊断信息都保持可信。
预期的访客 API 不暴露 Node 的文件系统、网络、进程、环境或模块加载 API。模块守卫和少量全局变量有助于让单元专注于工具编排;它们不会使 node:vm 对恶意 JavaScript 安全。当访客隔离属于你的威胁模型的一部分时,请使用 QuickJS;当你需要更强的宿主边界时,请使用单独的 OS 用户、容器或主机。
QuickJS 提供独立的 WASM 访客,没有环境宿主访问权限。如果你的工具策略授予权限,它仍然可以调用强大的工具。通过 Code Mode 工具桥发出的调用在任一执行器下都保留 OpenClaw 的正常策略、审批、钩子和会话所有权。这些检查对工具调用进行中介;它们无法遏制逃逸 Node VM 上下文的恶意代码。
设置执行器¶
在 Web 界面中,打开 Settings → Agents & Tools → Labs,使用 Code Mode executor 选择 Node.js(默认) 或 QuickJS(隔离)。激活和执行器选择是分开的:选择执行器不会启用 Code Mode。
要启用使用默认 Node 执行器的 Code Mode:
对于加固的访客隔离,在同一对象中设置 executor: "quickjs"。捆绑的插件 ID 是 code-mode-quickjs;选择其执行器无需单独的插件启用步骤。即使 plugins.enabled 为 false 或限制性的 plugins.allow 列表将其省略,显式选择执行器也会激活此捆绑运行时。它不会启用其他插件。显式的 plugins.deny 条目或 plugins.entries.code-mode-quickjs.enabled: false 仍会阻止它。外部插件可以提供 quickjs 执行器选项,并且仍然受完整的插件激活策略约束。对于该选项,请仅启用一个所有者。可选择的执行器 ID 是 node 和 quickjs;node 由核心拥有。
所选执行器必须可用。如果它缺失、被禁用、被拒绝或无法加载,运行将失败并返回 runtime_unavailable;OpenClaw 从不静默切换到 Node,也不会静默扩大直接工具暴露。当配置的 QuickJS 执行器不可用时,请检查插件策略。
设置 agents.entries.<agent>.tools.codeMode.executor 可为单个代理覆盖全局选择。省略该字段的代理将继承全局选择。有关激活优先级和限制,请参阅 Code Mode 配置。
理解等待与限制¶
每个单元在其整个生命周期内保持所选执行器,包括每次 wait。更改配置会影响新单元;它不会在引擎之间移动挂起的 JavaScript,也不会重放已完成的工具调用。
Node 在挂起时保留其活动的工作线程上下文。QuickJS 可以在序列化访客后释放其工作线程,并在 wait 时恢复快照。两种延续状态都是瞬态的:完成、失败、取消、过期或 Gateway 关闭都会释放它们。两者都无法在 Gateway 重启后存活。
timeoutMs、输出限制、待处理调用限制、挂起运行容量和 snapshotTtlSeconds 适用于两个执行器。历史名称 snapshotTtlSeconds 也控制 Node 的挂起上下文生命周期。宿主通过终止超时的工作线程(包括同步循环和 Promise 延续)来强制执行 Node 的执行截止时间。超时前发出的输出在配置的输出限制内仍然可用。QuickJS 还会根据 maxSnapshotBytes 检查序列化的 VM 状态。Node 没有序列化的 VM 快照,因此该设置不限制其活动堆。保存的 JSON 结果保留其共享内存/快照数据配额。
memoryLimitBytes 限制 QuickJS 访客内存。对于 Node,它配置一个跨老年代和新生代的尽力而为的 V8 工作线程堆预算,并受引擎最小值约束。该预算包括工作线程运行时分配,不包括外部缓冲区;它不是按上下文的堆度量或安全边界。两个执行器的此设置都不会限制 Gateway 的总 RSS。工作线程开销和宿主侧工具结果也会消耗内存。保留的 Node 上下文可能比大小受限的 QuickJS 快照使用更多的主机总内存。64 个挂起单元和预留恢复槽位的共享限制仍然适用;没有单独的全局内存配额。有关状态所有权和保留,请参阅 Code Mode 内部原理。
升级现有配置¶
Doctor 和符合条件的 Gateway 启动迁移会将显式的 runtime: "quickjs-wasi" 替换为 executor: "quickjs",并保留该显式选择。当两个字段同时存在时,已有的 executor 设置优先。激活和其他限制保持不变。
迁移后的显式 QuickJS 选择在通用插件被禁用或加入允许列表时也能正常工作,而无需启用无关插件。对 code-mode-quickjs 的显式拒绝仍会阻止执行。
未显式选择运行时的配置将使用新的 Node 默认值。显式设置 executor: "quickjs" 可保留加固的来宾隔离。已弃用的 runtime 字段不是运行时别名;对于旧配置,请使用 openclaw doctor --fix。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw