概述
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 在文档和配置路径中明确标注实验性功能,不会将预览行为偷偷放入稳定默认值。
相关页面
- features - 稳定功能特性总览
- models - 模型配置与本地模型支持
- memory-search - Memory 搜索配置