OpenClaw 实验性功能是 opt-in 预览功能，需要显式开启才能使用。对于本地小模型，开启 localModelLean 可移除三个默认工具（browser、cron、message）以降低上下文压力；其他实验性标志包括 sessionMemory、sandboxExecServer 和 planTool。验证状态可用 openclaw status --deep。注意实验性功能未稳定化，优先使用稳定配置路径。

OpenClaw 实验性功能配置与排查指南

实验性功能在 OpenClaw 中是 opt-in 预览面。它们被放在显式标志后面，因为在成为稳定默认值或长期公共契约之前，还需要实际使用里程。

对待它们与正常配置不同：

• 默认保持关闭，除非相关文档告诉你要试用。
• 预期形状和行为会比稳定配置变化更快。
• 如果已经有稳定路径，优先使用稳定路径。
• 如果你在大范围部署 OpenClaw，先在较小环境中测试实验性标志，再将其纳入共享基准。

当前文档化的标志

功能面	配置键	使用场景	更多信息
本地模型精简模式	agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean	当某个较小或更严格的本地后端在 OpenClaw 的完整默认工具面上卡住时	本地模型
记忆搜索	agents.defaults.memorySearch.experimental.sessionMemory	你需要 memory_search 索引先前的会话记录，并愿意承担额外的存储/索引成本	记忆配置参考
Codex Harness	plugins.entries.codex.config.appServer.experimental.sandboxExecServer	你想要原生 Codex app-server 0.132.0 或更新版本，指向 OpenClaw 沙箱支持的 exec-server 而不是禁用 Code Mode	Codex Harness 参考
结构化计划工具	tools.experimental.planTool	你想在兼容的运行时和 UI 中暴露结构化的 update_plan 工具，用于多步骤工作追踪	网关配置参考

本地模型精简模式

agents.defaults.experimental.localModelLean: true 是一个针对较弱本地模型设置的“减压阀”。开启后，OpenClaw 会在每次对话回合中从智能体的工具面上去掉三个默认工具——browser、cron、message。其他不受影响。你也可以用 agents.list[].experimental.localModelLean 只为某个智能体开启或关闭该行为。

为什么是这三个工具

这三个工具在默认 OpenClaw 运行时中拥有最大的描述和最多的参数形状。在小型上下文或更严格的 OpenAI 兼容后端上，这会导致：

• 工具 schema 无法干净地放入提示，反而挤占对话历史；
• 模型选错工具，因为相似的 schema 太多，发出格式错误的工具调用；
• Chat Completions 适配器超过服务器结构化输出限制，触发 400 错误（工具调用负载大小超限）。

去掉它们不会悄悄改动 OpenClaw 的其他逻辑——只是让工具列表变短。模型仍然拥有 read、write、edit、exec、apply_patch、网络搜索/获取（若配置）、记忆以及会话/智能体工具。

何时开启

当你能证明模型可以与网关正常通信，但完整智能体回合却表现异常时，开启精简模式。典型信号链：

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 逃生口。如果你需要为某个智能体永久缩小工具面，优先使用这些稳定配置，而不是实验性标志。

开启方法

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}

仅对单个智能体：

{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}

修改标志后重启网关，然后用以下命令确认工具列表已被修剪：

openclaw status --deep

深度状态输出会列出当前活动的智能体工具；当精简模式开启时，browser、cron 和 message 应不存在。

实验性并不意味着隐藏

如果某个功能是实验性的，OpenClaw 应在文档和配置路径中明确说明。它不应该把预览行为偷偷塞进看似稳定的默认配置中，假装这是正常的——那样会让配置面变得混乱。

相关文档

• 功能总览
• 发布渠道

常见问题

实验性功能怎么开启？

在配置文件中设置对应的实验性键，例如 agents.defaults.experimental.localModelLean: true，然后重启网关。开启后可用 openclaw status --deep 验证。

localModelLean 什么时候该打开？

当本地模型能通过 openclaw infer model run 简单测试，但完整智能体回合中出现工具调用错误、提示超长或模型忽略工具时，尝试打开。如果后端能正常处理默认工具集，则保持关闭。

实验性功能会变吗？

会。实验性功能的形状和行为可能比稳定配置变化更快。建议先在独立环境中测试，再用于生产部署。稳定路径存在时优先使用稳定路径。