跳转到内容

实验性功能

OpenClaw 中的实验性功能是可选加入的预览功能。它们之所以位于显式标志之后,是因为在它们有资格成为稳定的默认设置或长期存在的公共契约之前,仍需要现实世界的验证。

请以不同于正常配置的方式对待它们:

  • 除非相关文档告诉您尝试使用,否则请保持它们默认关闭
  • 预期其形状和行为的变化速度会比稳定配置快。
  • 当已经存在稳定的路径时,优先选择它。
  • 如果您正在广泛推广 OpenClaw,请在将实验性标志纳入共享基线之前,先在较小的环境中进行测试。
表面在以下情况下使用更多信息
本地模型运行时agents.defaults.experimental.localModelLeanagents.list[].experimental.localModelLean较小或较严格的本地后端无法处理 OpenClaw 的完整默认工具表面本地模型
内存搜索agents.defaults.memorySearch.experimental.sessionMemory您希望 memory_search 索引先前的会话记录并接受额外的存储/索引开销Memory 配置参考
结构化规划工具tools.experimental.planTool您希望结构化的 update_plan 工具暴露出来,以便在兼容的运行时和 UI 中进行多步骤工作跟踪Gateway(网关) 配置参考

agents.defaults.experimental.localModelLean: trueOpenClaw 是针对较弱的本地模型设置的压力释放阀。当它开启时,OpenClaw 会在每一轮中从代理的工具表面移除三个默认工具——browsercronmessage。其他一切保持不变。使用 agents.list[].experimental.localModelLean 可以为已配置的代理启用或禁用相同的行为。

这三个工具在默认的 OpenClaw 运行时中拥有最长的描述和最多的参数形式。对于上下文较小或更严格的 OpenAI 兼容后端,这意味着:

  • 工具架构可以整齐地放入提示词中,而不是挤占对话历史的空间。
  • 模型能够选择正确的工具,而不是因为存在太多外观相似的架构而发出格式错误的工具调用。
  • Chat Completions 适配器保持在服务器的结构化输出限制内,而不是因为工具调用负载大小而触发 400 错误。

移除它们不会静默地重新布线 OpenClaw——它只是使工具列表变短。模型仍然可以使用 OpenClawreadwriteeditexecapply_patch、网络搜索/获取(已配置时)、Memory 以及会话/代理工具。

当您已经证明模型可以与 Gateway(网关) 通信,但完整的 Agent 轮次出现行为异常时,请启用精简模式。典型的信号链是:

  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" 成功。
  2. 正常的 Agent 轮次失败,表现为工具调用格式错误、提示词过大,或者模型忽略了其工具。
  3. 切换 localModelLean: true 清除失败状态。

如果您的后端能够干净利落地处理完整的默认运行时,请保持此功能关闭。精简模式是一种权宜之计,而非默认设置。它的存在是因为某些本地堆栈需要更小的工具表面才能正常运行;托管模型和资源充足的本地设备则不需要。

精简模式也不能替代 tools.profiletools.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(网关),然后使用以下命令确认已精简的工具列表:

Terminal window
openclaw status --deep

深度状态输出列出了活动的代理工具;当开启精简模式时,browsercronmessage 应当不存在。

如果某个功能是实验性的,OpenClaw 应在文档和配置路径中明确说明。它不应做的是将预览行为偷偷混入看起来稳定的默认开关中,并假装这是正常的。这正是配置界面变得混乱的原因。