Skip to main content
OpenClaw 中的实验性功能是可选启用的预览能力。它们位于显式标志之后，因为在配得上稳定默认值或长期公开契约之前，它们仍然需要更多真实世界的使用验证。 将它们与普通配置区别对待：
  • 除非相关文档告诉你去尝试某个功能，否则保持它们默认关闭。
  • 预期其形态和行为变化会比稳定配置更快。
  • 如果已经存在稳定路径，优先使用稳定路径。
  • 如果你要在更大范围内推广 OpenClaw，请先在较小环境中测试实验性标志，然后再将它们纳入共享基线。

​
当前已文档化的标志

SurfaceKeyUse it whenMore
Local model runtimeagents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean更小或更严格的本地后端在处理 OpenClaw 的完整默认工具面板时会吃不消本地模型
Memory searchagents.defaults.memorySearch.experimental.sessionMemory你希望 memory_search 为之前的会话转录建立索引，并接受额外的存储/索引成本内存配置参考
Codex harnessplugins.entries.codex.config.appServer.experimental.sandboxExecServer你希望原生 Codex app-server 0.132.0 或更新版本将目标指向由 OpenClaw 沙箱支持的 exec-server，而不是禁用 Code ModeCodex harness 参考
Structured planning tooltools.experimental.planTool你希望在兼容的运行时和 UI 中暴露结构化的 update_plan 工具，用于多步骤工作跟踪网关配置参考

​
本地模型精简模式

agents.defaults.experimental.localModelLean: true 是较弱本地模型设置的一个压力释放阀。启用后，OpenClaw 会从每一轮代理工具面板中移除三个默认工具——browser、cron 和 message。当 tools.toolSearch 未显式配置时，它也会默认该运行使用结构化 Tool Search 控制，因此更大的插件、MCP 或客户端工具目录会停留在 tool_search、tool_describe 和 tool_call 之后，而不是被直接塞进提示词中。需要直接投递 message 的运行会保持该工具为直接可用，而不是启用精简模式下的 Tool Search 默认行为。可使用 agents.list[].experimental.localModelLean 为某个已配置代理单独启用或禁用同样的行为。

​
为什么是这三个工具

这三个工具在默认的 OpenClaw 运行时中拥有最长的描述和最多的参数形状。对于小上下文或更严格的 OpenAI 兼容后端而言，这意味着：
  • 工具 schema 能否干净地放入提示词中，还是会挤占对话历史。
  • 模型能否选中正确的工具，还是因为相似 schema 太多而发出格式错误的工具调用。
  • Chat Completions 适配器能否保持在服务端结构化输出限制之内，还是会因工具调用负载大小触发 400 错误。
移除它们不会悄悄改写 OpenClaw——它只是让直接工具列表更短。模型仍然可以使用 read、write、edit、exec、apply_patch、Web 搜索/抓取（在已配置时）、memory 以及 session/agent 工具。额外目录仍可通过 Tool Search 调用，除非你明确设置了 tools.toolSearch: false。

​
何时启用

当你已经证明模型可以与 Gateway 通信，但完整的代理轮次表现异常时，启用精简模式。典型的信号链是：
  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" 成功。
  2. 正常的代理轮次因格式错误的工具调用、提示词过大，或模型忽略其工具而失败。
  3. 切换 localModelLean: true 后故障消失。

​
何时保持关闭

如果你的后端能够干净地处理完整默认运行时，就保持关闭。精简模式是一种变通方案，不是默认设置。它之所以存在，是因为某些本地栈需要更小的工具面板才能正常工作；托管模型和资源充足的本地设备则不需要。 精简模式也不能替代 tools.profile、tools.allow/tools.deny，或模型的 compat.supportsTools: false 逃逸阀。如果你需要为某个特定代理永久使用更窄的工具面板，应优先使用这些稳定选项，而不是实验性标志。 如果你已经在全局调优 Tool Search，OpenClaw 会保持该 operator 配置不变。设置 tools.toolSearch: false 可退出精简模式下的 Tool Search 默认行为。

​
启用

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
仅针对一个代理： 
{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}
更改标志后重启 Gateway，然后使用以下命令确认裁剪后的工具列表： 
openclaw status --deep
深度状态输出会列出当前启用的代理工具；当精简模式开启时，browser、cron 和 message 应该不会出现，除非当前投递模式强制直接回复 message。

​
实验性并不意味着隐藏

如果一个功能是实验性的，OpenClaw 应当在文档和配置路径本身中明确说明。它不应该做的是把预览行为偷偷塞进一个看起来稳定的默认选项里，然后假装那是正常的。配置接口变得混乱，往往就是这样开始的。

​
相关