实验性功能

实验性功能是由配置标志控制的预览性能力。在它们的形态和行为成为长期契约之前，需要更多真实场景的检验。

• 默认关闭，除非功能文档另有说明。
• 形态和行为的变化可能比稳定配置更快。
• 当已有稳定路径时，优先使用稳定路径。
• 先在较小环境中测试，再大规模推广。

所有插件 API也都是实验性的。 该稳定性标签不要求普通插件启用 Labs 开关；下方的 Custom plugin UI 标志仅控制用户安装的原生浏览器代码。

当前已记录的标志¶

Control UI 实验室¶

打开 Settings → Labs 来管理带有 Control UI 开关的实验。启用或禁用某个实验会立即修改权威 Gateway 配置，无需重启 Gateway。

Labs 包括决策辅助、Code Mode、适用于所有模型的 Tool Search、Custom plugin UI、Host Desktop 和 Cloud Worker Desktop。在默认的重载模式下，自定义插件视图和桌面可用性会在已连接的 Control UI 页面中更新。Code Mode 和 Tool Search 的更改会在后续 agent 运行中生效。禁用 Custom plugin UI 后，请重新加载浏览器标签页，以清除已经运行过的插件 JavaScript。Cloud Worker Desktop 实验控制对现有支持桌面的 worker 的访问；更改某个 profile 的 settings.desktop 只会影响新建的 worker。

Custom plugin UI 默认关闭。已启用的内置插件（包括 Workboard）在该设置关闭时仍会保留其原生 UI。后端 API 和普通插件仍然可用，安装或批准插件工件不会启用该实验。

Code Mode 会保持禁用，直到你打开其 Labs 开关，或显式将 tools.codeMode 设置为 true 或 "auto"。该 Labs 开关会写入 "auto"，因此它只对标记为 Code Mode 优选执行者的模型生效，而不会对每个模型强制启用 Code Mode。

当 tools.toolSearch 未设置时，Tool Search 默认启用。关闭其 Labs 开关会禁用全局默认值；打开则会恢复该默认值。

决策辅助¶

仅限 Foundation： 此 Labs 条目会保存意图，但不会连接任何自动 Decision 消费方。开启它不会启动推断、启用消费方模式、选择提供方、配置凭据或下载模型。

该开关与手动编写的配置使用同一个全局布尔值：

{
  agents: {
    defaults: {
      experimental: { decisionAssistance: true },
    },
  },
}

默认值为关闭。只有显式的 true 才会选择启用；省略、false 或不相关的实验性选项均不会。类似 decisionAssistance: { enabled: true } 的对象是无效的。关闭 Labs 开关会移除其覆盖值并恢复为关闭状态，同时保留模型选择和其他同级设置。不存在浏览器本地偏好设置。

已保存的启用选择并不等同于逐 agent 资格。未来的自动消费方还需要为其所属 agent 具备有效的决策模型。未设置的 agent 模型会继承 agents.defaults.decisionModel；显式将 agents.entries.<id>.decisionModel 设为空会禁用该 agent 的资格。单独选择模型永远不会启用该功能。全局开关并不意味着每个 agent 都有资格，也不意味着已配置的提供方已就绪。如果没有模型，启用偏好仍会保存，但无法运行任何自动 Decision 推断。

显式的 decision_evaluate 工具在其正常的模型选择和工具策略契约下独立于 Labs。Labs 不会限制共享的 Decision 运行时或提供商注册，也从不授予执行操作的权限。

核心消费者契约¶

核心实现可以从 src/agents/decision-assistance.ts 导入 isDecisionAssistanceEligible(config: OpenClawConfig, agentId: string): boolean。请提供已准备好的配置和受信任的拥有者 agent ID，而不是模型提供的 ID。该辅助函数恰好返回 decisionAssistance === true && resolveDecisionModelSetting(config, agentId) !== undefined。它不会执行提供商探测、密钥解析、文件读取、网络请求、模型加载或推理，也不会返回提供商就绪诊断。这是一个内部基础边界，而不是新的插件 SDK 接口面。

例如，在未来的自动消费者边界处：

import { isDecisionAssistanceEligible } from "./decision-assistance.js";

if (!isDecisionAssistanceEligible(preparedConfig, owningAgentId)) {
  return existingBaseline;
}
// Separately check this consumer’s explicit mode, harness support, and authority
// before loading its optional implementation or preparing evaluation evidence.

使用现有的配置发布/刷新生命周期，而不是文件轮询。未来消费者必须在选择退出生效后停止接受自动工作，并在应用等待的结果之前重新验证当前配置、模型选择和实时权限。此辅助函数不是权限令牌或取消所有者。

任何未来消费者都必须记录其证据传输、成本、延迟和失败行为。托管评估会将选定的证据发送到已配置的提供商，并可能产生费用；此基础不发送证据，也不对性能或质量作出声明。

本地模型精简模式¶

精简模式是一种高级故障排查覆盖，在 Labs 之外配置。其现有的 experimental.localModelLean 键仍受支持。有关功能限制、配置示例和恢复指南，请参阅 本地模型精简模式。

• 为什么是这些工具
• 何时开启
• 何时保持关闭
• 启用

实验性并不意味着隐藏¶

实验性功能应在文档和配置路径本身中明确说明，而不是隐藏在一个看似稳定的默认选项后面。

相关¶

• 功能
• 发布渠道