概述

OpenClaw 的实验性功能是可选的预览接口,放在显式 flag 后面,因为它们还需要真实世界的使用验证,才能成为稳定默认值或长期公开契约。

核心要点

使用原则:

  • 默认关闭,除非相关文档建议尝试
  • 形状和行为变化比稳定配置更快
  • 有稳定路径时优先使用稳定路径
  • 大规模部署前先在小环境测试

当前已记录的实验性 flag:

功能配置键使用场景
本地模型精简模式agents.defaults.experimental.localModelLean较小/严格的本地后端无法处理完整工具面
Session 内存搜索agents.defaults.memorySearch.experimental.sessionMemory让 memory_search 索引历史 session transcript
结构化规划工具tools.experimental.planTool暴露 update_plan 工具用于多步骤工作追踪

**本地模型精简模式(localModelLean)**详解:

  • 开启后从 agent 工具面中移除 browser、cron、message 三个工具
  • 这三个工具有最大的描述和最多的参数形状,在小上下文或严格 OpenAI 兼容后端中会导致工具 schema 挤占对话历史
  • 适用信号:openclaw infer 成功但正常 agent turn 出现格式错误的工具调用或超大 prompt
  • 不替代 tools.profile、tools.allow/deny 或 compat.supportsTools: false
{
  agents: {
    defaults: {
      experimental: { localModelLean: true }
    }
  }
}

设计原则:实验性不等于隐藏。OpenClaw 在文档和配置路径中明确标注实验性功能,不会将预览行为偷偷放入稳定默认值。

相关页面