Skip to main content
实验性功能是位于显式标志之后的可选预览界面。它们需要更多真实场景验证，才会获得稳定默认值或长期契约。
  • 默认关闭，除非文档告诉你启用某项功能。
  • 形态和行为可能比稳定配置变化更快。
  • 如果已经存在稳定路径，优先使用稳定路径。
  • 先在较小环境中测试，再进行大范围推出。

​
当前记录在文档中的标志

界面键适用场景更多
本地模型运行时agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean较小或更严格的本地后端无法处理 OpenClaw 的完整默认工具界面本地 Models
记忆搜索agents.defaults.memorySearch.experimental.sessionMemory你希望 memory_search 索引先前的会话转录，并接受额外的存储/索引成本记忆配置参考
Codex harnessplugins.entries.codex.config.appServer.experimental.sandboxExecServer你希望原生 Codex app-server 0.132.0 或更新版本指向一个由 OpenClaw 沙箱支持的 exec-server，而不是禁用代码模式Codex harness reference
结构化规划工具tools.experimental.planTool你希望在兼容的运行时和 UI 中暴露结构化 update_plan 工具，用于多步骤工作跟踪Gateway 配置参考

​
本地模型精简模式

agents.defaults.experimental.localModelLean: true 会在每个轮次中从智能体的直接界面移除重量级可选工具：browser、cron、message、image_generate、music_generate、video_generate、tts 和 pdf。显式允许或交付所需的工具仍然可用，不过 Tool Search 可能会将它们编入目录，而不是直接暴露。精简模式还会在 tools.toolSearch 尚未设置时，默认将插件/MCP/客户端目录设为结构化 Tool Search（tool_search、tool_describe、tool_call）。使用 agents.list[].experimental.localModelLean 将此限定到一个智能体。 如果你已经全局调优 Tool Search，OpenClaw 会保持该配置不变。设置 tools.toolSearch: false 可退出精简模式的 Tool Search 默认值。

​
为什么是这些工具

这些工具的描述最长、参数形态最宽泛，或最有可能让小模型偏离正常的编码和对话路径。对于小上下文或更严格的 OpenAI 兼容后端，这会造成以下差异：
  • 工具模式能够放入提示词，而不是挤占对话历史。
  • 模型选择正确工具，而不是因太多相似模式而发出格式错误的工具调用。
  • Chat Completions 适配器保持在结构化输出限制内，而不是因工具调用载荷大小返回 400。
移除它们只会缩短直接工具列表。模型仍然拥有 read、write、edit、exec、apply_patch、图像理解、Web 搜索/获取（配置后）、记忆，以及会话/智能体工具。除非你设置 tools.toolSearch: false，额外目录仍可通过 Tool Search 访问；显式工具允许可让精简智能体重新加入经过裁剪的工作流。

​
何时开启

在你证明模型可以与 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 逃生口。若要在特定智能体上使用永久更窄的工具界面，优先使用这些稳定旋钮。

​
启用

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
仅用于一个智能体： 
{
  agents: {
    list: [
      {
        id: "local",
        model: "lmstudio/gemma-4-e4b-it",
        experimental: {
          localModelLean: true,
        },
      },
    ],
  },
}
更改标志后重启 Gateway 网关。精简过滤会移除 browser、cron、message、image_generate、music_generate、video_generate、tts 和 pdf，除非你使用 tools.allow 或 tools.alsoAllow 显式保留它们；Tool Search 仍可能将保留的工具编入目录，而不是直接暴露。

​
实验性不等于隐藏

实验性功能应在文档和配置路径本身中明确说明，而不是隐藏在看似稳定的默认旋钮之后。

​
相关