跳转至

Code Mode 配置

配置

全局 tools.codeMode 设置缺失时,默认值为 "auto"。如果你编写一个 Code Mode 对象,除非该对象显式设置 enabled,否则其激活状态保持关闭;这允许你在不启用该 功能的情况下预置执行器或限制设置。简写 false 也会禁用它。代理和模型覆盖保留 其现有优先级。

字段 默认值 限制范围
enabled 见上文 false、true 或 "auto"(按模型)
executor "node" "node" 或 "quickjs"
mode "only" 暴露控制/直接工具,并编目其余工具
timeoutMs 10000 100-60000
memoryLimitBytes 67108864 1048576-1073741824
maxOutputBytes 65536 1024-10485760
maxSnapshotBytes 10485760 1024-268435456
maxPendingToolCalls 16 1-128
snapshotTtlSeconds 900 1-86400
searchDefaultLimit 8 限制到 maxSearchLimit
maxSearchLimit 50 1-50

Code Mode 仅执行 JavaScript。Doctor 和符合条件的 Gateway 启动 迁移会从全局和按代理的 Code Mode 配置中移除已弃用的 languages 设置,同时保留激活状态和限制。

默认 Node 执行器使用 node:vm 进行受信任执行,而非安全 隔离。选择 executor: "quickjs" 以使用内置的加固来宾运行时。 代理级执行器设置会覆盖全局选择。请参阅 Code Mode 执行器 了解安全、内存、等待 和升级行为。maxSnapshotBytes 限制 QuickJS VM 快照和 共享的已保存结果额度;它不限制 Node 保留的实时上下文。

timeoutMs 是每次 exec 或 wait 调用的实际时钟预算。工作进程准备、来宾 计算和内联工具等待共享该预算;审批等待会暂停它。 对于显式 awaitResults: true 的单元格,VM 外工具等待也会暂停 执行额度。相同的未使用额度会在结算后恢复; 工作进程准备和来宾执行永远不会获得新的预算。现有的 代理运行和工具截止时间在必需等待期间继续运行。 面向模型的 exec 描述包含有效限制。阻塞式来宾 计算如果耗尽预算,会以 timeout 失败。未完成的工具调用 可以改为返回 waiting,以便稍后的 wait 使用新的调用 预算恢复它们。无头续行在排队和初始化之后,也会遵守精确的工作进程准入预算,并同时受其配置的切片限制和单一 无头实际时钟截止时间约束。检查点不会重置该实际时钟截止时间。 当 shell exec 工具可用时,请用它执行更重的计算 ,并让来宾 JavaScript 专注于协调工具和处理结果。

如果 Code Mode 已启用但所选执行器无法加载,OpenClaw 会针对该运行失败关闭 ;它不会静默暴露常规工具作为回退。这 适用于 true,也适用于模型解析为首选的 "auto" 运行: 已启用 Code Mode 的运行绝不会静默回退到另一个执行器或广泛的直接 工具暴露。

按模型自动激活

tools.codeMode.enabled 接受三个值:

  • false:除非代理或模型覆盖启用它,否则 Code Mode 关闭。
  • true:除非覆盖禁用它,否则 Code Mode 会为具备工具能力的运行启用。
  • "auto":仅当运行的模型在其提供商目录中被标记为首选 Code Mode 表现者时,Code Mode 才会启用。

当全局设置完全缺失时,OpenClaw 的行为等同于 "auto"。未包含 enabled 的手动编写对象行为等同于 false。这些值 在没有代理或模型覆盖具有优先级时提供默认值。"auto" 使用目录能力;显式的按模型布尔值会绕过该能力 偏好。

compat.codeMode 目录标志

提供商目录可以在其模型条目上使用 compat.codeMode 对模型进行分级, 位于 compat.supportsTools 等标志旁边:

  • "preferred":该模型能够可靠地编写简短的编排程序,并从紧凑的 Code Mode 接口中受益;"auto" 会启用 Code Mode。
  • "capable"(或缺失):该模型在通过 enabled: true 强制启用时可以运行 Code Mode,但 "auto" 保持常规工具暴露。

不支持工具的模型完全无法使用 Code Mode;没有单独的 "unsupported" 分级。该标志是由提供商插件目录拥有的能力元数据;核心只读取通用的 compat 字段。

内置首选模型

内置提供商目录当前将这些模型标记为 "preferred":

提供商 模型
anthropic claude-fable-5, claude-opus-5-5, claude-opus-5, claude-sonnet-5, claude-mythos-5, claude-opus-4-8
deepseek deepseek-v4-pro, deepseek-v4-flash
google gemini-3-flash-preview, gemini-3.1-pro-preview, gemini-3.1-flash-lite, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3.6-flash, gemini-3.7-flash
kimi k3, k3-256k
提供商 模型
minimax MiniMax-M3
moonshot kimi-k3
openai gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.5-pro
xiaomi mimo-v2.6-pro, mimo-v2.6-flash
zai glm-5.3, glm-5.2, glm-5.1

claude-haiku-4-5 被标记为 "capable":它仍可通过显式的 true 代理或模型设置保持可用,但 "auto" 不会启用它。

其他所有内容,包括所有由 Ollama 提供的本地模型,都保持未标记状态,并在 "auto" 下保持正常工具暴露。

由多个提供商提供的模型

多个供应商可通过多个提供商 ID 访问:订阅端点与 API 端点并存,或转售其他供应商模型的网关。由于 "auto" 会从为运行提供服务的任一目录中解析级别,描述同一上游模型的两个目录不应意外不一致。

因此,对于共享模型,一旦任一同级行声明了级别,每个目录行都会显式声明其级别。行根据供应商对权重的自身名称进行匹配,因此以命名空间 ID 或不同大小写重新发布模型的目录会自动匹配:novita/moonshotai/kimi-k3、nvidia/z-ai/glm-5.2 和 together/deepseek-ai/DeepSeek-V4-Pro 都会与第一方行归为一组,无需任何人声明。只有真正不同的名称才需要清单中的 upstreamModel 标记,正如 kimi 目录对 moonshot/kimi-k3 所做的那样。

诸如 baseten、deepinfra、github-copilot、gmi、novita、nvidia、ollama-cloud、opencode、opencode-go、qianfan、together、venice 和 volcengine-plan 等转售商和聚合器目录目前对第一方目录标记为 "preferred" 的模型声明 "capable":首选级别来自第一方端点上的评估,并且这些运行未针对每个转售商重复。提升其中某一行是有意且基于证据的变更,而不是疏忽。

对于 OpenAI 模型,该标记仅在运行解析到 OpenClaw 嵌入式代理运行时时才重要。默认 OpenAI 路由使用 Codex 风格的 harness 界面,OpenClaw 代码模式不适用;目录标记不会改变该路由决策。

选择何时启用

代码模式可以通过用紧凑目录和一个程序替代重复的完整工具架构和中间模型轮次,来减少 Token 使用。结果取决于模型和工作负载。在广泛强制启用之前,请在代表性任务上比较正确性和完整的根及后代 Token 用量。

当代理在模型之间切换时,使用 "auto":首选模型获得紧凑界面,其他模型保持正常工具暴露。当已验证某个未标记模型在代码模式下表现良好时,在精确模型条目上使用 true。对于开放权重或未缓存的服务,如果每个 Prompt Token 都计费或重新计算,建议按模型启用(通过 "auto" 或显式模型覆盖),而不是全局启用,因为 Token 节省取决于模型是否真正很好地使用程序界面。

激活

代码模式在已知有效工具策略之后、组装最终模型请求之前进行评估:

  1. 解析代理、模型、提供商、沙箱、通道、发送者和运行策略。
  2. 构建有效的 OpenClaw 工具列表,添加符合条件的插件、MCP 和客户端工具。
  3. 应用允许/拒绝策略。
  4. 使用代理和模型优先级解析激活。 如果为 false,或为 "auto" 且运行的模型不是目录首选,则继续正常工具暴露。
  5. 如果已启用且运行中有工具处于活动状态,保留必需的仅限直接工具,并将每个符合目录条件的有效工具注册到代码模式目录中。
  6. 从模型可见列表中移除已编目工具;在保留的仅限直接工具旁边添加 exec 和 wait。

有意没有工具的运行(原始模型调用、disableTools: true 或空的 tools.allow 列表)即使配置了 tools.codeMode.enabled: true 也不会激活代码模式界面。代码模式和 OpenClaw Tool Search 在一次运行中互斥;如果代码模式激活,Tool Search 的压缩不会激活。

代码模式目录是运行范围的,不得泄露来自其他代理、会话、发送者或运行的工具。

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