- 除非文档描述了范围明确的自动设置规则,否则默认关闭。
- 其结构和行为的变化速度可能快于稳定配置。
- 如果已有稳定路径,请优先使用。
- 仅在较小环境中先行测试后,才进行广泛部署。
当前已记录的标志
Control UI 实验室
打开 Settings → Agents & Tools → Labs,管理带有 Control UI 开关的实验。启用或禁用实验室功能会立即修补规范的 Gateway 网关 配置;仅当某项功能需要重启时,页面才会显示重启提示。 代码模式和 Swarm 是目前已发布的实验室条目。两个开关均会 写入现有的、已验证的配置键,并且通常无需重启 Gateway 网关, 即可对后续智能体运行生效。本地模型精简模式
agents.defaults.experimental.localModelLean: true 会在每轮中从智能体的直接界面移除重量级可选工具:browser、cron、message、image_generate、music_generate、video_generate、tts 和 pdf。显式允许或交付所需的工具仍然可用,但工具搜索可能会将其收录到目录中,而不是直接公开。未设置 tools.toolSearch 时,精简模式还会默认将插件/MCP/客户端目录设为结构化工具搜索(tool_search、tool_describe、tool_call)。使用 agents.entries.*.experimental.localModelLean 可将此设置限定到一个智能体。
在新手引导期间,经过验证的 ollama 或 lmstudio 推理路由会在缺少该值时自动设置 agents.defaults.experimental.localModelLean: true。OpenClaw 会记录该设置来自新手引导,因此之后经过验证的非本地路由只会撤销自动设置。显式配置的 true 或 false 会得到保留。不会根据模型名称或 URL 推断其他自托管提供商和 OpenAI 兼容提供商。
如果你已全局调整工具搜索,OpenClaw 会保留该配置不变。设置 tools.toolSearch: false 可选择不使用精简模式的默认工具搜索设置。
在结构化 tools 模式下,精简运行会使 exec 与工具搜索控件并列且保持直接可见,以便针对编码调优的本地模型仍可选择其熟悉的 shell 路径。这仅改变架构可见性:常规工具策略、沙箱隔离和 Exec 审批仍然适用。显式的 code 和 directory 模式会保留其常规压缩行为。
为什么选择这些工具
这些工具的描述最长、参数结构最广,或最有可能使小型模型偏离正常的编码和对话路径。对于上下文较小或限制更严格的 OpenAI 兼容后端,这决定了以下差异:- 工具架构能够放入提示词,而不是挤占对话历史的空间。
- 模型能够选择正确的工具,而不是因为存在过多相似架构而发出格式错误的工具调用。
- Chat Completions 适配器能够保持在结构化输出限制以内,而不是因工具调用负载过大而返回 400。
read、write、edit、exec、apply_patch、图像理解、Web 搜索/获取(配置后)、记忆以及会话/智能体工具。除非设置 tools.toolSearch: false,否则仍可通过工具搜索访问其他目录;显式允许工具可以使精简智能体重新使用已被精简的工作流。
何时启用
确认模型能够与 Gateway 网关通信,但完整智能体轮次行为异常后,再启用精简模式:openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"成功。- 常规智能体轮次因工具调用格式错误、提示词过大或模型忽略工具而失败。
- 切换
localModelLean: true后故障消失。
何时保持关闭
如果后端可以顺利处理完整的默认运行时,请保持关闭。它是针对需要更小工具界面的本地技术栈的变通方案,并非托管模型或资源充足的本地设备的默认设置。 精简模式不能替代tools.profile、tools.allow/tools.deny 或模型的 compat.supportsTools: false 备用机制。若要为特定智能体永久缩小工具界面,请优先使用这些稳定的配置项。
启用
tools.allow 或 tools.alsoAllow 显式保留,否则精简筛选会移除 browser、cron、message、image_generate、music_generate、video_generate、tts 和 pdf;工具搜索仍可能将保留的工具收录到目录中,而不是直接公开。