快速开始
实验性功能
实验性功能是需要通过显式标志选择启用的预览功能。它们需要经过更多实际使用验证，才能获得稳定的默认设置或长期有效的契约。
- 默认关闭，除非文档要求你启用。
- 其结构和行为的变化速度可能快于稳定配置。
- 如果已有稳定路径，请优先使用稳定路径。
- 只有先在较小的环境中完成测试，才能广泛部署。
当前已记录的标志
| 功能范围 | 键 | 适用场景 | 更多信息 |
|---|---|---|---|
| 本地模型运行时 | agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean |
较小或限制更严格的本地后端无法处理 OpenClaw 完整的默认工具功能范围 | 本地模型 |
| 记忆搜索 | agents.defaults.memorySearch.experimental.sessionMemory |
你希望 memory_search 为之前的会话记录建立索引，并愿意承担额外的存储和索引成本 |
记忆配置参考 |
| Codex harness | plugins.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。显式允许或交付所需的工具仍然可用，但工具搜索可能会将其列入目录，而不是直接公开。未设置 tools.toolSearch 时，精简模式还会默认让插件、MCP 和客户端目录使用结构化工具搜索（tool_search、tool_describe、tool_call）。使用 agents.list[].experimental.localModelLean 可将此设置限定到单个智能体。
如果你已在全局调整工具搜索，OpenClaw 会保留该配置不变。设置 tools.toolSearch: false 可退出精简模式的工具搜索默认行为。
在结构化 tools 模式下，精简运行会让 exec 与工具搜索控制项一起保持直接可见，使针对编码优化的本地模型仍可选择其熟悉的 shell 路径。此设置只改变 schema 的可见性：常规工具策略、沙箱隔离和 Exec 审批仍然适用。显式的 code 和 directory 模式会保留其正常的压缩行为。
为什么选择这些工具
这些工具具有最长的描述、最广泛的参数结构，或最容易分散小型模型对常规编码和对话路径的注意力。对于上下文较小或限制更严格的 OpenAI 兼容后端，这决定了以下差异：
- 工具 schema 能够装入提示词，还是挤占对话历史的空间。
- 模型能够选择正确的工具，还是因过多相似的 schema 而生成格式错误的工具调用。
- 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 应急选项。如果要永久缩小特定智能体的工具功能范围，请优先使用这些稳定的配置项。
启用
{ agents: { defaults: { experimental: { localModelLean: true, }, }, },}仅针对一个智能体：
{ agents: { list: [ { id: "local", model: "lmstudio/gemma-4-e4b-it", experimental: { localModelLean: true, }, }, ], },}更改此标志后重启 Gateway 网关。除非使用 tools.allow 或 tools.alsoAllow 显式保留，否则精简过滤会移除 browser、cron、message、image_generate、music_generate、video_generate、tts 和 pdf；工具搜索仍可能将保留的工具列入目录，而不是直接公开。
实验性并不意味着隐藏
实验性功能应在文档和配置路径本身中明确标示，而不是隐藏在看似稳定的默认配置项之后。
