v2026.8.1: 插件与集成
管理员现在可以通过 Control UI 浏览、搜索、安装、启用、禁用和移除插件,同一中心还可以安装经过精选的 ClawHub 技能并添加经过审核的 MCP 连接器。受管安装会在需要时暂停以进行来源审查,将失败的更改回滚到可重试状态,并在不丢弃健康配置的情况下修复过期或不完整的记录。插件更新还会让正在进行中的工作继续使用其启动时的版本,只有在替代版本成功加载后,后续工作才会切换到新版本。
ClawHub 安装会在桌面端和移动端之间携带所选发布者、版本、扫描状态和来源;当连接或目录发生变化时,MCP 服务器会独立恢复;插件作者可获得类型化的 Gateway 和 SDK 契约,用于基于 OpenClaw 进行构建。与厂商无关的 Agent 插件可以将技能和受支持的 MCP 服务器与作用域存储结合在一起,为集成提供从软件包到运行系统的更清晰路径。
安装和管理插件
管理员现在可以在 Control UI 中浏览和搜索已安装的插件,查看每个插件提供的内容,启用或禁用它,移除外部插件,安装经过精选的 ClawHub 结果,并添加经过审核的 MCP 连接器。只读操作员可以查看相同的清单,而 Web 表单无法安全表示的高级来源、更新和配置仍可通过命令行使用。
从任意软件包、仓库、归档、本地路径或市场来源进行的首次安装会暂停以进行明确审查。仍需要设置的插件可以保持禁用状态,失败的受管安装会将部分更改回滚,以便可以正常重试。修复可以恢复过期或不完整的安装代次,同时保留健康配置,而完整性或版本漂移仍然需要审查。
插件列表和诊断现在可以区分已禁用的插件、发现或验证失败、活动运行时失败以及后台服务失败。使用 plugins doctor 进行本地发现和配置检查,使用 openclaw health 检查运行中系统的插件和服务状态。某些安装和移除操作仍需要重启后才能生效。
来源和完整变更列表
改进
- 要求对任意插件来源进行确认 #102197
- 在 Control UI 中管理插件和 MCP 连接器 #103176
- 允许 Codex 轮次使用已批准的工作区目录插件 #104188
- 将插件控制项直接放在卡片和行上 #106040
- 在 Control UI 中显示插件目录插图 #109510
- 为安装策略警告添加经审查的确认 #116489
- 加速每个
openclaw plugins list表单 #117900 - 大幅加快已配置 CLI 帮助和状态的加载速度 #124562
- 稳定 Plugins 中心的导航和控制 #126061
- 在插件列表中使用受信任的托管元数据 #109629
- 按最近更新时间对精选插件排序 #110273
- 澄清 Plugins 导航并对齐设置控制项 #110482
- 使用当前元数据快照加速插件列表 #115353
- 通过 Gateway 加速钩子状态命令 #118288
- 加速 Doctor 插件契约检查 #120811
- 加速冷启动 Telegram 频道设置 #122955
- refactor(plugins): 将同意变更与清单分离 #131146
- perf(plugins): 将状态数据库写入机制排除在元数据读取路径之外 #131417
- 对齐插件过滤器样式 #106168
- 澄清 MXC 沙箱设置并警告出站网络访问 #110256
- 添加规范的 Plugins Discover URL #115587
- 加速插件 doctor 和设置加载 #120876
- 移除已退役的 ACPX 配置键 #120937
- 延迟渲染屏幕外的插件行 #125585
- 在插件兼容性警告中添加故障排查步骤 #94019
Bug 修复
- 阻止在插件和技能安装中注入 Git 选项 #102398
- 减少插件列表启动内存占用 #103132
- 在 npm 元数据检查失败时保留健康插件 #107063
- 从不完整的锁元数据中恢复受管 npm 插件 #107294
- 从过期的受管安装中恢复插件生命周期命令 #107691
- 升级后加载活动的受管插件代次 #111141
- 序列化插件生命周期更改并保留需要设置的安装 #112763
- 报告插件安全扫描中的所有可执行调用 #116222
- 在管理视图中保留所选代理的工作区插件 #117265
- 在恢复期间保留插件安装记录 #121045
- 在多入口插件包的整个生命周期中保持一致性 #121174
- 授权来自已发现 Codex 市场的插件 #122389
- 拒绝空白的技能凭据值 #108848
- 保持 Control 的精选插件与受信任的 ClawHub 策展一致 #109418
- 将不可读的插件清单报告为权限失败 #110200
- 让根命令和插件 CLI 帮助能够干净退出 #111322
- 在 Doctor 修复期间遵循配置的插件加载路径 #113200
- 跨兼容性 ID 保留插件设置 #114521
- 在槽位选择前强制实施受支持的插件类型 #114537
- 重新安装后加载替代 npm 插件 #114713
- 防止有效插件被过期的 npm 元数据隔离 #115610
- 在 Codex 迁移期间报告损坏的策展市场 #115865
- 从仅 pnpm 的覆盖语法中恢复插件安装 #116245
- 保留技能凭据并对配置更新进行排序 #116749
- 在 plugins doctor 中显示可操作的警告 #117357
- 市场更新后刷新运行中的 Gateway #117724
- 移除已禁用插件拥有的频道配置 #118127
- 插件更新保留索引策略并安全回滚 #119228
- 将安全的插件安装警告返回给管理员 #120783
- 从清单中恢复插件配置标签 #121329
- 修复捆绑插件清单和 Talk 语音配置 #121354
- fix(plugins): 允许在出站频道架构不一致时安装 #122984
- 为去重后的捆绑插件保留受管所有权 #123063
- 在没有系统所有者的情况下保持插件清单可用 #123378
- 在插件检查期间保留较新数据库错误 #125493
- fix(plugins): 在离线市场中列出 MXC #126211
- 在瞬时启动失败后恢复插件目录 #126815
- fix(ui): 移除过时的插件生命周期反馈 #127273
- fix(plugins): 在安装时报告缺失清单而不是误导性的 ID 不匹配 #128527
- fix(cli): 渲染钩子报告 JSON 失败 #128641
- fix(cli): 在插件安装提示中保留活动目标 #129283
- fix(plugins): 在抛出的失败中回滚受管 npm 安装状态 #130884
- fix(plugins): 拒绝在现有受管检出上执行 git 安装 #131175
- fix(plugins): 在状态检查期间避免重复读取清单 #131334
- fix(cli): 避免在启动时重复准备插件 #131503
- fix(plugins): 在注册表恢复前保留读取错误 #131521
- 为新添加的扩展刷新过期的插件注册表 #96080
- 在不重写用户配置的情况下更新插件记录 #98422
- 在深度安全审计期间限制插件清单读取 #101773
- 当主目录变量为空时正确查找全局插件 #102413
- 防止插件更新和卸载误读原型命名的记录 #102872
- 在插件修复期间遵循 Doctor 当前的安装策略 #103808
- 允许 Control UI 管理员通过严格允许列表启用已安装插件 #106318
- 在批准前恢复插件来源验证 #107768
- 拒绝空白的必填钩子环境值 #108928
- 允许 CLI 插件卸载以缩减配置 #110991
- 修正可选插件 CLI 启用指南 #112019
- 在插件列表 JSON 中省略未观察到的 harness ID #112235
- 通过 npm 包名称查找 Control UI 插件 #113933
- 解释 npm 插件安装静默失败的原因 #114215
- 报告缺失的插件文件而不产生误报的边界警告 #115053
- 在 beta 版上停止重复的 bundledDiscovery 迁移通知 #115208
- 将无事件钩子报告为未就绪 #116083
- 一致地显示无事件钩子状态 #116127
- 报告缺失的插件依赖并给出可操作的错误提示 #117029
- 在经身份验证的 HEAD 请求中保留图标元数据 #117079
- 阐明 plugins doctor 实际检查的内容 #117160
- 保持 marketplace JSON 输出可解析 #117307
- 在软件包安装之前拒绝重复的钩子名称 #117439
- 在冷插件清单中报告 manifest 声明的工具 #117461
- fix(plugins): 报告已注册的检查能力 #117518
- 当插件策略阻止启用时返回错误 #117536
- 在 CLI 输出中解释已过滤的已安装插件 #117556
- 在 plugins doctor 中显示已验证的插件警告 #118526
- 在卸载期间移除过时的插件加载路径 #118930
- 加快对缺失频道插件的状态检查 #119203
- 对格式错误的插件图标路由返回 404 #119559
- 在 HEAD 请求上保留缺失图标的元数据 #120133
- 阻止 Doctor 将频道元数据视为插件 #120891
- 防止重复的 Skills 页面预加载请求 #123705
- 在聊天安装后显示所需的插件设置 #123727
- 当 skills 信息缺失时返回失败状态 #123997
- 显示插件清理、设置和 CLI 加载失败 #124570
- 让钩子开关可以选择代理工作区 #124761
- 一致地报告过时的插件注册表 #125048
- 当无法读取已安装插件的元数据时发出警告 #125117
- 显示插件策略拒绝而不采用崩溃框架 #125304
- 阻止全新安装显示误报的插件注册表修复警告 #126799
- 在 Skills 命令中拒绝未知的代理 ID #126954
- 从失败的 skills 命令返回 JSON 错误 #127016
- fix(cli): 为钩子启用/禁用失败提供后续步骤 #127370
- fix(cli): 呈现插件搜索的 JSON 失败 #127679
- fix(plugins): 在漂移修复命令中规范化修正版本 #127800
- fix(plugins): 在默认插件列表中显示加载错误 #128849
- fix(plugins): 名称冲突时检查会加载错误的插件 #129079
- fix(plugins): doctor 将受支持的纯钩子插件报告为不健康 #129083
- fix(plugins): 列表静默隐藏发现和注册表失败 #129091
- fix(plugins): 正常禁用被报告为错误 #129158
- fix(health): 已激活插件的失败被静默省略 #129161
- fix(cli): 将插件更新恢复提示保留在活动容器内 #129231
- fix(plugins): 在另一个插件失败时保留健康的 CLI 命令 #129248
- fix: 当 marketplace 列表失败时返回 JSON #129263
- fix(plugins): 在 Plugins Hub 中将缺失依赖显示为错误 #129480
- fix(plugins): 避免插件检查中出现重复的命令名称 #130339
- fix(plugins): 在运行时检查中报告 registerFull 路由 #130904
- fix: 在匹配键别名之前检查确切的钩子名称 #131081
- fix(ui): 使插件中心的标题和选项卡与内容对齐 #131239
- fix(ui): 缩小过大的插件垃圾桶图标 #131280
- fix(plugins): 从清单中隐藏已卸载的 TGZ 插件 #131880
- fix(plugins): 每次调用解析一次 CLI 插件元数据 #131884
- fix(plugins): 在 CLI 和聊天检查中显示包来源 #133140
文档
- 修正扩展安装命令 [#112057](https://github.com/openclaw/openclaw/pull/112057)
- docs(plugins): 在生成的插件清单中注册 imap [#130363](https://github.com/openclaw/openclaw/pull/130363)
- docs: 修正 Copilot Proxy 的默认启用状态 [#131164](https://github.com/openclaw/openclaw/pull/131164)
- docs(plugins): 修正内置覆盖优先级 [#132181](https://github.com/openclaw/openclaw/pull/132181)
</details>
ClawHub、Claws 与技能共享
ClawHub 现在会在审核和安装过程中携带所选发布者、版本、扫描结果和确切来源,即使两个技能同名也是如此。在技能或插件安装之前,其 ClawHub 安全审计会显示确切发布版本、Safe(安全)、Review(需审核)或 Blocked(已阻止)结果、ClawHub 概览和审计链接。“需审核”结果会提供相应上下文,并继续走常规确认流程,而非设置第二道风险门槛;而“已阻止”发布仍然无法安装。Mac、iPhone、iPad 和 Android 用户使用相同的发布者、版本和审计契约,而外部 skills.sh 结果则保留其固定的来源身份,并明确标记为不在 ClawHub 扫描范围内。
除非操作员明确强制覆盖,否则技能更新会保护本地编辑和并发编辑。直接下载会验证声明的摘要,并在支持的大小限制内检查完整归档;没有指纹的旧版受管安装需要一次强制更新来建立该基线。
实验性 Claws 可将代理与受管工作区文件、技能、插件、MCP 服务器和计划任务打包在一起。你可以在应用前预览确切计划;更新和移除仅作用于 Claw 拥有的资源;共享资源会保留在原位,除非你特意选择冲突感知清理。使用相同 ID 重新创建 Claw 时,现在会等待旧 Claw 的清理完成,因此中断的移除会保持隔离且可重试,而不会删除替换状态。Claws 仍受 OPENCLAW_EXPERIMENTAL_CLAWS=1 控制;不确定的外部操作可能留下可见的部分状态,需要重新制定计划;此外,该包不会携带其不拥有的凭据、提供方、绑定、任意本地路径、可执行配置、会话或主机状态。
来源与完整变更列表
改进
- 安全预览实验性 Claw 代理包 #101328
- 添加经同意的 Claw 代理安装 #101755
- 在 Android 上管理技能并从 ClawHub 安装 #101864
- 创建 Claw 管理的受管工作区文件 #101973
- 绑定签名的 ClawHub 目录信任并使其过期 #101981
- 为实验性 Claws 安装精确的 ClawHub 包 #102228
- 检查并安全移除实验性 Claw 代理 #102296
- 将已安装的代理导出为可移植 Claw 包 #102306
- 让实验性 Claws 安全管理 MCP 服务器所有权 #102406
- 向 Doctor 添加实验性只读 Claw 生命周期诊断 #102427
- 安全预览分组的 Claw 代理更新 #102959
- 将受同意约束的更新应用到已安装的 Claws #102982
- 让 Android 技能管理更易于浏览和审核 #105592
- 在 iOS 和 macOS 上添加原生技能管理 #105814
- 添加人工编写的 CLAW.md 清单 #111391
- 安装外部 skills.sh 目录引用 #112751
- 将可移植 Claw 身份与 OpenClaw 策略分离 #112773
- 让 CLAW.md 携带可移植的代理提示词 #113454
- 添加可移植的 OpenClaw 配置文件与原生 Claw 引导 #115237
- 随 Claw 包导出经审核的首次运行说明 #115371
- 为 schema-v1 Claw 配置文件添加插件要求 #115962
- 添加实验性本地 Claw 创作生命周期 #117037
- 加载仓库技能以及代理工作区技能 #125786
- feat(clawhub): 在安装前显示安全审计 #131233
- 在刷新和快照复用期间验证签名的市场订阅源 #98338
- 将技能上传暂存移入 SQLite #108346
- 在 Control UI 中显示 ClawHub 技能图标 #114152
- 为签名的市场订阅源配置信任密钥 #98316
- 在 CLI 输出中公开签名的市场订阅源信任 #98350
- 通过 grizzly CLI 添加 Bear Notes 技能 #120
Bug 修复
- 重试瞬态 ClawHub 包读取 #105388
- fix(skills): 阻止技能更新破坏本地技能更改 #118190
- 在安装过程中保留外部 ClawHub 技能身份 #124250
- fix(skills): 在解压前拒绝被篡改的下载归档 #129486
- 遵循标准 ClawHub 插件 API 比较器 #106889
- 规范化代理 git 包安装身份 #107637
- 在密钥轮换期间保留签名订阅源的回滚保护 #108342
- 拒绝签名插件目录中的畸形时间戳 #109742
- 接受标准 DSSE 插件目录订阅源 #110037
- 在首次加载技能时显示 ClawHub 安全判定 #110166
- 安装正确的推荐技能并保持失败可重试 #111518
- 显示并安装备选技能 CLI 要求 #113767
- 强化实验性 Claw 的添加和移除生命周期 #114670
- 在 Claw 就绪检查中报告缺失的插件凭据 #114899
- 恢复技能依赖安装的同意流程 #116644
- 在审核和安装过程中保留所选 ClawHub 发布者 #121697
- 安全恢复 Claw 生命周期所有权 #123254
- 在技能解压前拒绝不完整的 tar 列表 #125406
- fix(claws): 未更改的所属技能不再阻止更新 #126479
- fix(cli): 拒绝源技能中仅用于 ClawHub 的标志 #128162
- fix(claws): 在清理期间保持删除隔离 #128500
- fix(skills): 限制安装程序下载 #129630
- fix(native): 移除不支持的 ClawHub 确认重试 #131979
- fix(android): 停止提供过时的 ClawHub 确认重试 #132016
- 恢复通过 ClawHub 发布 Fish Audio 05e3ce1
- 迁移 Claude 命令描述时保留 Unicode #102616
- 将 ClawHub 推荐刷新保持在超时时间内 #105411
- 忽略畸形的 ClawHub Retry-After 时间 #105479
- 通过受管锁文件链接全局安装的 ClawHub 技能 #106479
- 拒绝 ClawHub 推荐订阅源中的不可能日期 #106942
- 在 ClawHub 技能验证失败时发出警告 #107143
- 在 ClawHub 发布错误中保留 emoji #108172
- 忽略畸形的 ClawHub 速率限制重置提示 #108815
- 为重复的 ClawHub 技能结果显示发布者 #110903
- 拒绝 ClawHub 响应中的畸形 UTF-8 #111164
- 将 ClawHub 技能搜索结果保持在一个终端行内 #111441
- 拒绝托管插件目录中的畸形 UTF-8 #111768
- 阻止 doctor 将当前 OCM 技能路径标记为过期 #112236
- 澄清未验证插件的信任指南 #112249
- 统计成功的 ClawHub 插件安装 #113133
- 通过受管代理路由技能验证 #113683
- 为版本固定的技能保留启动保护措施 #114924
- 将技能命令提示保持在所选实例上 #117555
- 安全移除按所有者限定的 ClawHub 技能 #119606
- 将 Fish Audio 插件迁移到其规范身份 #119900
- 保持技能验证错误机器可读 #123761
- 保持 Claws 更新 JSON 输出可解析 #124130
- 为缺失的 ClawHub 技能提供可操作错误 #124764
- 使缺失技能验证错误可操作 #125317
- 保持 Claw 项目工件在不同运行时下确定性一致 #125801
- 修复 ClawHub 预发布兼容性检查 #126020
- 将缺失的 ClawHub 技能指向搜索 #126987
加载和更新插件
插件更新 现在会为正在进行中的工作保留一个运行时代际。已接受的消息、补全和 worker 会以它们启动时的插件版本完成运行,后续工作只会在替换版本成功加载后才切换到新版本。如果热重载失败,OpenClaw 会恢复上次活跃的命令、提供者、钩子、内存及其他注册项。
OpenClaw 还会跨轮次复用已准备的插件元数据和运行时,而不是每次重新构建相同的环境,同时健康状态会直接显示失败的激活、清理或后台服务。已知的插件自身故障可以被隔离,而无需将健康插件或整个 OpenClaw 下线;但无效配置、迁移失败、所有权不明确以及无法验证的状态仍会阻止激活。
上下文引擎插件在新轮次中仍会被选中,并且可以通过将限制应用于已接受的轮次而非全部累积历史,在长时间会话中推进持久状态。现有的 v1 引擎在采用新接口之前继续保持其全历史契约,单个超过 8 MiB 或 20,000 事件的已接受轮次仍然会停止。
来源和完整变更列表
改进
- 降低捆绑的 Ollama 插件带来的非活动启动成本 #119745
- 跨热 Gateway 轮次复用插件准备结果 #105646
- 为插件入口副作用添加持久的重放防护 #110846
- 在重复的目录读取中复用插件通道发现结果 #114324
- 在加载期间复用已准备的插件元数据 #114807
- 减少插件密集场景下的 Gateway 启动时间和内存 #115020
- 从 Gateway 轮次中移除重复的插件指纹计算工作 #118334
- 在 agent 工具构建期间复用已准备的插件上下文 #118398
- 将可选的 xAI 能力运行时推迟到首次使用时 #119374
- 延迟加载 Anthropic 会话目录 #119619
- 复用未更改的沙箱技能快照 #121379
- perf(plugins): 在 secrets 热路径上复用生命周期元数据 #126629
- 在技能监视器刷新期间复用插件元数据 #127088
- perf(plugins): 统一渐进式插件缓存所有权 #131442
- perf(plugins): 在提供者发现期间避免导入 logging #132744
- 避免在路由和状态路径中进行冷插件加载 #109348
- 阻止插件元数据查找轮询磁盘 #114289
- 避免对缺失的插件外观进行重复查找 #124664
- perf(plugins): 每个 CLI 进程复用一个插件元数据快照 #129181
- perf(agents): 避免在流式传输期间创建未使用的扩展上下文 #130158
Bug 修复
- 防止 Codex 插件发现阻塞 agent 轮次 #108311
- 当某个 secret 失败时保持健康技能可用 #109791
- 当某个配置的插件损坏时保持 Gateway 运行 #110239
- 保留捆绑插件的发现和作用域化激活 #114547
- 减少重复的插件注册表路径扫描 #115783
- 在一次性 agent 运行期间保持已安装插件可用 #116336
- 恢复已配置 agent 轮次的已准备运行时复用 #117768
- 统一插件 webhook 路由所有权和启动失败处理 #118203
- fix(plugins): 将格式错误的清单模式与插件加载和配置验证隔离 #119825
- 保留多入口插件和关联的安装源 #120026
- 阻止重复的插件扫描导致 gateway 冻结 #120344
- 在新轮次中保持已配置的上下文引擎活跃 #121461
- 减少重复插件元数据发现导致的 Gateway 停顿 #124844
- 在 agent 运行时路径中保持已分析的插件工具可用 #124947
- 阻止插件元数据重新扫描导致 Gateway 停滞 #125596
- 跨 Gateway 实例隔离插件运行时所有权 #125821
- 防止终止的上下文引擎行降低后续轮次的性能 #126593
- fix: 不透明目标的插件会话绑定失败 #132733
- fix: 在启动时缺少受信任的运行时插件时恢复会话 #132804
- fix(channels): 遵循受信任插件激活契约 (#114492) 9b77c06
- 跨已准备的 Gateway 运行时保留已构建的插件 ef91c81
- 停止对不可用通道插件的重复扫描 #100377
- 防止递归的提示构建钩子分发 #102554
- 当热重载失败时保持活跃插件正常工作 #103812
- 在插件注册失败后清理调度器任务 #106890
- 在注册失败后完全恢复插件状态 #108084
- 在同一个注册中保持有状态的插件钩子和工具 #108110
- 在缓慢的 Telegram 发送期间保留 Device Pair 通知 #108164
- 防止源码安装时出现重复的捆绑插件实例 #108508
- 防止 ACPX 进程清理挂起 #109146
- 在突发期间限制回复钩子的使用元数据 #109610
- 在通道运行时上下文被销毁时释放中止监听器 #109708
- 防止无响应的插件中间件冻结 agent 运行 #110731
- 加载没有清单的已配置独立插件文件 #111515
- 在插件重新加载时刷新提供者元数据 #112699
- 在 CLI 进程退出时释放共享状态租约 #113839
- 跨生命周期和 agent 运行隔离 Gateway 插件状态 #114476
- 在重连期间保留 ACPX 进程所有权 #115247
- 避免 agent 轮次期间的插件元数据停滞 #115426
- 限制插件钩子等待并淘汰过时的注册 #115695
- 在模型所有者之前发布插件激活的 Gateway 配置 #115747
- 跨共享运行时保持 Codex 应用清单最新 #115866
- 在正确的数据库上保持插件注册表状态 #116427
- 恰好一次清理失败的插件服务启动 #116804
- 在插件生命周期变更后刷新通道元数据 #117005
- 修正插件诊断并稳定发现顺序 #117025
- 将延迟的插件转换保存在持久缓存中 #117355
- 保持持久化的插件注册表快照一致 #117561
- 在插件路由就绪之前返回可重试的 503 #117852
- 遏制被拒绝的同步插件钩子 #117988
- 在插件停止时释放 llama.cpp 模型内存 #119238
- 为本地 agent 执行加载已安装的 agent 框架 #119855
- 防止已停止的 ACPX 运行时返回 #120029
- 停止虚假的遗留上下文引擎降级警告 #120722
- 在运行时可用性变化时刷新 ACPX 技能 #121181
- fix(beam): 重试失败的终端镜像上传 #121186
- 在长时间会话中保持持久上下文引擎持续推进 #121647
- 在长时间会话中保持上下文引擎状态持续推进 #122149
- 使插件设置注册具有原子性 #123506
- 保留失败插件诊断而不激活能力 #125046
- 在健康状态中显示插件服务失败 #125366
- 将压缩操作保持在单个已准备的插件代际上 #125688
- 将补全和 worker 保持在单个插件代际上 #125761
- 在 Gateway 轮次中保持单个插件代际 #125990
- 在已受理的插件代次上保持代理回合 #126626
- 防止 Gateway 重载后出现过期的插件状态 #126627
- 将 Gateway 启动时的运行时加载限制为仅活动插件 #126703
- 在生命周期变更时淘汰可执行插件缓存 #126719
- 加载执行工作区技能时复用已准备的插件元数据 #126720
- 在过期加载失败后保留已刷新的插件提取器 #126829
- fix(plugins): 使用替换停止超时约束启动失败服务的清理 #126907
- fix(plugins): 在生命周期重置后重新加载已替换的设置模块 #128110
- fix(agents): 防止重载丢失排队回复或恢复过期凭据 #128138
- fix(plugins): 防止重复的后台服务和发现广播器 #128179
- fix(hooks): 在恢复的 mtime 编辑后重新加载可变处理器 #128477
- fix(agents): 保留插件工具的终止行为 #128505
- perf(plugins): 强制只加载一次——默认凭据源门控与隔离注册表复用 #128639
- fix(plugins): 在激活回滚后保持通道的权威性 #129232
- fix(plugins): 阻止已退役的回调更改运行上下文 #129250
- fix(sessions): 将维护逻辑与通道插件解析器隔离 #129490
- fix(plugins): 暴露无效的后台服务和发现服务 #129651
- fix(agents): 将回退式插件注册表加载限定到活动运行时注册表 #130167
- fix(plugins): 注册期间插件运行时不可用时安全失败(fail closed) #130597
- fix(sandbox): 随注册表生命周期淘汰插件后端 #130662
- fix(plugins): 报告失败的插件斜杠命令而非静默忽略 #130743
- fix(plugins): 保持 SecretRef 配置可加载 #131310
- fix: 跨工作区刷新插件时 Gateway 启动失败 #131936
- fix(plugins): 随运行时注册淘汰加载器缓存 #132093
- fix(plugins): 加载源产物而不丢失凭据目标 #132166
- fix(plugin-sdk): 保留环境代理解析 #132541
- fix(gateway): 阻止进程内重启期间堆内存增长 #132933
- fix(channels): 在代理工作区之前解析已注册插件 (#124709) 4f59053
- 在路由失败后完成插件 HTTP 响应 #102125
- 在 ACPX Codex 错误诊断中保留 Unicode #103738
- 当代理停止时取消待处理的捆绑 LSP 工具 #104110
- 在注册后保持插件运行上下文可用 #107028
- 在插件发现期间忽略 TypeScript 声明文件 #107994
- 通过清单 ID 识别配置的插件依赖 #113691
- 防止仅包含路径的引导文件导致代理回合崩溃 #115395
- 在元数据更新后刷新捆绑插件产物的位置 #117041
- 使插件验证重启指导与安装方式无关 #119508
- 将 ACPX 句柄操作保持在同一会话快照上 #120924
- 为直接代理入口加载已配置的插件运行时 #121787
- 当插件路由分发失败时返回 HTTP 500 #124033
- 阻止已取消的 llm-task 调用返回过期 JSON #124673
- 在激活前拒绝缓存的插件加载失败 #126737
- fix(plugins): 限制允许列表警告历史 #127126
- fix(agents): 为通道回合保留已受理的运行时代次 #127217
- perf(agents): 复用活动的 Gateway 插件代次 #127278
- fix(diffs): 防止轻量 CLI 注册在 runtime.state 不可用时崩溃 #128360
- fix(plugins): 在检查期间显示已注册的 Gateway 发现服务 #130267
- fix(plugins): 汇总设置错误并回滚失败的通道 #131983
- fix(plugins): 将并发目录接纳范围限定到每个代理 #132734
MCP 服务器与应用
MCP 服务器 现在可以在延迟启动、传输丢失、服务器重启或工具列表变更后恢复其连接和目录,而无需重启 OpenClaw,也不会拖垮健康的服务器。工具结果会保留结构化数据、截图、音频、资源、恢复指引以及真实的错误状态。如果某次调用首次发现某个有状态会话已过期,该调用仍会失败一次且不会重放,因为该会话可能已经对某些内容产生了更改。
本地 MCP 登录可以在浏览器中完成,保存并验证凭据,并在进程重启后恢复新启动的授权流程。共享操作员登录仍是默认方式,同时受支持的 HTTP MCP 服务器可以选择启用按人 OAuth,使每个凭据都与受信任的渠道、机器人账号和发送者绑定。远程和无头操作员继续使用手动代码路径;这个最初的按人模式不会新增私密登录投递、自动回合恢复或 Control UI 账户管理。
MCP Apps 仍然是可选启用,在完成所需配置并重启后,可以显示受支持的交互式服务器界面。它们会将信任扩展到服务器提供的 UI 代码,重建的对话视图保持只读,应用上下文会作为不受信任的输入进入下一轮。无头节点可以将请求-响应式 MCP 工具发布到 Code Mode,而 OAuth、流式传输、通知、采样和移动端发布仍不属于这第一个节点托管版本。
来源与完整变更列表
改进
- 新增按请求方作用域的 MCP 连接 #106359
- 新增一个需同意授权的 MCP App 消息桥接与实时主机上下文 #109807
- 新增一个基于票据的只读独立 MCP App 主机 #109861
- 在独立 MCP Apps 中启用工具和资源 #110515
- 让交互式 MCP Apps 提供单轮模型上下文 #111212
- 让原生插件声明 MCP Apps #113224
- 与嵌入式 MCP apps 共享 Control UI 样式 #113464
- 为节点 MCP 服务器提供类型化的 Code Mode 命名空间 #114876
- 为 MCP 服务器新增按请求方 OAuth #122166
- 在 Control UI 中新增可选启用的沙盒 MCP Apps #69039
- 节点托管的工具、MCP 服务器和技能 #90431
- 懒加载 MCP Apps 聊天桥 #106288
- 集中管理 MCP OAuth 身份和可恢复的登录状态 #122115
- 缓存不可变的捆绑 MCP 配置发现结果 #79882
Bug 修复
- 从共享聊天 show 输出中脱敏 MCP 凭据 #103396
- 让 MCP 服务器配置不进入群组回复 #103502
- 将 MCP 刷新令牌绑定到其签发方 #112032
- 在结构化结果之外保留非文本 MCP 内容 #115521
- fix(gateway): 接管独立 MCP App 请求的生命周期 #119388
- 在浏览器批准后完成 MCP OAuth 登录 #120431
- 实时恢复节点托管的 MCP 目录和会话 #125092
- 防止过期的 MCP 目录和静默工具失败 #125564
- 将已解决的 OpenClaw 工具故障标记为 MCP 错误 #126472
- 在会话重置或删除后清理过期的 MCP 进程 #93559
- 让 MCP OAuth 凭据在 CLI 和本地 Codex 运行时中可用 #96120
- 抑制 MCP 通知的响应 #101730
- 使用配置的超时限制停滞的 MCP OAuth 请求 #103704
- 保留节点 MCP 配对和断线恢复 #104745
- 在静默轮次和重新加载之间保留 MCP App 预览 #105728
- 保留所有 MCP 字面量联合操作 #108054
- 在 MCP App CSP 元数据格式错误时安全失败 #108883
- 在 CLI 运行清理后保持共享 MCP 传输存活 #110251
- 让嵌入式 MCP Apps 在视图关闭前完成清理 #111124
- 拒绝 MCP App 沙盒策略中格式错误的 UTF-8 #111282
- 在服务器恢复后重试 MCP 工具目录 #111962
- 在注册表变更时保留按请求方作用域的 MCP 解析器 #112579
- 在断线和反复超时后恢复捆绑的 MCP 服务器 #113916
- 拒绝保留的
__proto__MCP 服务器名称 #116112 - 限制 MCP 目录分页和加载时间 #116845
- 对独立 MCP Apps 显示超时而不是让其挂起 #119276
- 隔离过大的 MCP stdout 帧,而不是让主机崩溃 #119379
- 通过浏览器回调完成 MCP OAuth 登录 #120433
- fix(mcp): 保留客户端和请求方的生命周期所有权 #120894
- 在登录期间复用有效的 MCP OAuth 会话 #122129
- 让 Codex MCP 批准设置和死胡同具有可操作性 #124766
- 解释超时的 Codex MCP 批准 #125860
- 在结构化 MCP 工具结果中保留恢复指引 #125914
- 淘汰过期的 MCP 传输和进程树 #126101
- 修复 MCP 渠道媒体、事件投递和清理 #126592
- fix(node-host): 防止中断后出现 MCP 重连风暴 #128196
- fix(ai): 展平根级 anyOf 工具架构时保留根属性 #128799
- fix(codex): 使用带点号的 MCP 工具名称的轮次最终无声且无回复 #128900
- fix: 修复 Gateway 替换后渲染过期仪表盘应用视图的问题 #130172
- fix(mcp): 避免元数据和清理逻辑导致运行时被提前加载 #133028
- fix(gateway): 保留独立 MCP App HEAD 响应的元数据 (#120905) 6f4b9a2
- 在 MCP 工具架构中保留以 prototype 命名的字段 #102856
- 修复存储在直接包含配置中的 MCP 标志 #103970
- 拒绝并修复不支持的 MCP 禁用设置 #104495
- 拒绝十六进制的 MCP 超时选项 #104633
- 防止过大的计时器设置导致 MCP 立即超时 #105769
- 将过大的 MCP 超时限制在 Node 安全范围内 #105784
- 限制并发的 MCP doctor 探测 #109870
- 拒绝格式错误的已解码 MCP 沙盒策略元数据 #110275
- fix(mcp): 防止分块 stdio 诊断信息被损坏 #110652
- 当 initialize 超时时使 MCP 设置失败 #111318
- 保持仅资源型 MCP 服务器可用 #115169
- fix(agents): 为 server-name 的 toolsAllow globs 物化 MCP #115277
- 在服务器重启后重新连接有状态 MCP 工具 #115614
- 在 MCP App 沙盒 HEAD 响应中保留 Content-Length #118553
- 让 MCP doctor 遵循 Windows PATH 的大小写 #121595
- fix(cli): 合并嵌套的 MCP configure 和 tools 补丁 #124551
- fix(mcp): 对受阻塞的 stdio env 警告去重 #128102
- fix(mcp): 防止 add 替换现有服务器 #128129
- fix(cli): 不区分大小写地识别 OAuth 授权头 #129279
- fix(codex): 保留已禁用的 MCP 传输 #130872
- fix(doctor): 在警告中忽略已禁用的 MCP 服务器 #131352
- fix(agents): 配置变更时使已公布的 MCP 目录失效 #131793
- fix(macos): MCP Apps 保持在仪表盘内部 #132096
构建插件与集成
现在,构建 Gateway 客户端 或嵌入 OpenClaw 的开发者可以使用类型化协议模式、运行时验证、身份验证、重连、就绪、超时以及浏览器或 Node 入口点指南。Gateway 协议和参考客户端已准备好作为日历版本化的 npm 包,并将在发布列车发布后可供安装。
插件作者 还可以获得针对请求者感知钩子、渠道设置、CLI 后端、有界提供商流、只读密钥引用和浏览器会议适配器的专门契约。钩子策略仍然位于渠道准入、沙箱、审批、仅所有者工具和其他主机策略之下,并且 Codex 钩子中继的超时清理适用于 POSIX 主机,而非 Windows。
契约清理移除了已退役的七月和八月 SDK 路径,并将 deactivate 别名替换为 gateway_stop,而 beta.5 会话存储桥接器在 2026 年 10 月 12 日之前仍然可用。使用 v2026.7.2 beta 的 question、worker 或 session-catalog 形状的客户端需要迁移到重命名并扁平化后的契约。自定义的 agents.defaults.cliBackends 命令、参数、环境、别名和解析器现在属于后端插件,其可执行文件对 OpenClaw 服务可用。
来源与完整变更列表
改进
- 将嵌入式运行的启动阶段发布到诊断系统 #107984
- 向插件工具钩子暴露请求者身份 #111190
- 通过插件提供商向 Control UI 添加会话讨论 #111337
- 添加渠道拥有的设置契约 #112176
- 将 CLI 后端适配器从配置迁移到插件中 #112539
- 添加事实优先的媒体 API,同时保留旧版兼容性 #113355
- 添加全新的无工具模型补全 #114343
- 退役 Slack 内联回复指令,以支持类型化呈现 #114738
- 加速 Codex 原生钩子启动 #115078
- 退役八月插件 SDK 兼容路径 #124416
- 为 CLI 后端添加插件拥有的 JSONL 解析 #95386
- 保持增量 Swift 协议字段的源代码兼容性 #103493
- 添加共享的插件 SDK HTML 转义辅助工具 #105975
- 添加一个规范的插件配置合并辅助工具 #106919
- 提取共享的会议机器人运行时和适配器 SDK #109755
- 为扩展添加可靠的会话空闲事件 #110174
- 在替换过程中添加有界转录游标 #110374
- 整合渠道能力和附件提示 #110985
- 在公开包发布之前清理网关协议契约 #111041
- 退役全局插件 SDK 提供商发布 #111426
- 移除过期的插件 SDK 兼容表面 #111451
- 将 Gateway 协议包发布到 npm #111664
- 为 npm 发布准备 Gateway 客户端 #111707
- 向分派前钩子暴露规范的入站消息身份 #112359
- 在原生文本渠道之间共享属性化 Markdown 渲染 #112907
- 为每个消费者一次性规范化入站回复文本 #113179
- 为渠道 DM 策略设置添加共享的插件 SDK 契约 #113537
- 将工具取消转发到插件钩子 #115817
- 将 GitHub Copilot OAuth 所有权移入其提供商插件 #118063
- 在 Gateway 终端中启动新的 CLI 代理会话 #121020
- 退役已弃用的插件 SDK 导入和 deactivate 钩子别名 #121845
- 添加仅提供商的视频输入契约 #121887
- 添加规范的 Computer Use 提供商 SDK #123509
- 添加共享的插件 SDK 流和 SecretRef 工具 #124835
- 复用共享缓存实现 WhatsApp 去重 #104962
- 弃用 Discord 中止信号辅助工具,同时不破坏导入 #109166
- 在类型化步骤上统一计划更新回调 #109660
- 移除旧版媒体占位符解析 #111891
- 共享渠道探测计时和错误处理 #113540
- 为消息审批目标添加共享的插件 SDK 解析器 #113568
- 移除已被取代的 sessions.observer.ask Gateway 方法 #113791
- 统一实时提供商模型投影 #113903
- 添加标准的原始事件入口配置 #117859
- 共享插件迁移和密钥契约辅助工具 #120346
- 将 Chutes OAuth 刷新移入提供商插件 #120840
- 移除未使用的 Gateway RPC 和客户端表面 #121387
- 退役旧版上下文引擎主机参数默认值 #122434
- 从专用媒体 SDK 导出受管理的 URL 摄取 #125278
Bug 修复
- 恢复官方测试版插件升级和 Repo E2E [#105287](https://github.com/openclaw/openclaw/pull/105287)
- 防止超时的 Codex 钩子中继耗尽 Linux 内存 [#109446](https://github.com/openclaw/openclaw/pull/109446)
- 将 Codex 钩子中继限制为工具插件目标 [#109603](https://github.com/openclaw/openclaw/pull/109603)
- 保持插件下一轮注入在注册后仍可调用 [#111131](https://github.com/openclaw/openclaw/pull/111131)
- 恢复已发布频道插件的兼容性并保留并发安装记录 [#113101](https://github.com/openclaw/openclaw/pull/113101)
- fix(gateway): 隔离 SDK 事件流并保留重连所有权 (#116904) [b611914](https://github.com/openclaw/openclaw/commit/b611914)
- fix(plugin-sdk): 保留已发布的调用方契约 [e1199b1](https://github.com/openclaw/openclaw/commit/e1199b1)
- 让插件工具使用受支持的提供商凭证 [#103852](https://github.com/openclaw/openclaw/pull/103852)
- fix(cron): 中止已被取代的协调钩子 [#104368](https://github.com/openclaw/openclaw/pull/104368)
- 拒绝本地工具模式引用中的非规范数组索引 [#105922](https://github.com/openclaw/openclaw/pull/105922)
- 清理已弃用的 SDK 导出并现代化 Zalo 投递 [#106010](https://github.com/openclaw/openclaw/pull/106010)
- 终止已完成的原生 Codex 钩子中继 [#106899](https://github.com/openclaw/openclaw/pull/106899)
- 保持认领钩子超时由注册持有 [#107996](https://github.com/openclaw/openclaw/pull/107996)
- 让回复钩子认领普通用户轮次 [#108353](https://github.com/openclaw/openclaw/pull/108353)
- 净化 Plugin SDK SSRF 辅助程序中的格式错误 URL 错误 [#109729](https://github.com/openclaw/openclaw/pull/109729)
- 防止已准备的频道轮次生命周期泄漏 [#110981](https://github.com/openclaw/openclaw/pull/110981)
- 让 ACP 帮助和 stdin EOF 能够干净退出 [#111091](https://github.com/openclaw/openclaw/pull/111091)
- fix(sessions): 拒绝被更改的可见消息游标 [#111264](https://github.com/openclaw/openclaw/pull/111264)
- 将频道设置标志移入插件清单 [#112239](https://github.com/openclaw/openclaw/pull/112239)
- 保持频道配置提升由插件持有 [#112293](https://github.com/openclaw/openclaw/pull/112293)
- 更安全的清单驱动提供商注册 [#114381](https://github.com/openclaw/openclaw/pull/114381)
- 将 DeepInfra 嵌入迁移到受支持的插件契约 [#114727](https://github.com/openclaw/openclaw/pull/114727)
- 恢复提供商流兼容性导出 [#115757](https://github.com/openclaw/openclaw/pull/115757)
- 明确声明上下文引擎主机参数 [#115872](https://github.com/openclaw/openclaw/pull/115872)
- 恢复 OpenAI Chat 响应钩子生命周期 [#117056](https://github.com/openclaw/openclaw/pull/117056)
- 保留仅契约频道的设置和智能体绑定 [#117106](https://github.com/openclaw/openclaw/pull/117106)
- 防止小数分块限制导致文本投递停滞 [#117727](https://github.com/openclaw/openclaw/pull/117727)
- 在客户端握手失败时停止 ACP 服务器 [#117901](https://github.com/openclaw/openclaw/pull/117901)
- 整合插件辅助程序并修复 Voice Call 和 Vault 行为 [#118509](https://github.com/openclaw/openclaw/pull/118509)
- 当旧版钩子注册无法接收类型化事件时发出警告 [#118601](https://github.com/openclaw/openclaw/pull/118601)
- 报告格式错误的插件模式引用而不崩溃 [#120254](https://github.com/openclaw/openclaw/pull/120254)
- 保持 OpenAI Responses 钩子在请求超时内 [#121163](https://github.com/openclaw/openclaw/pull/121163)
- 让外部 Plugin SDK 入口点类型兼容 [#121512](https://github.com/openclaw/openclaw/pull/121512)
- fix: 防止提示词模板和审批替换中的 $-pattern 注入 [#123015](https://github.com/openclaw/openclaw/pull/123015)
- fix(plugins): 恢复已发布频道的兼容性 [#126003](https://github.com/openclaw/openclaw/pull/126003)
- fix(sessions): 当探测保留被禁用时保留模型运行会话 [#128023](https://github.com/openclaw/openclaw/pull/128023)
- fix(agents): 将带有已失效 pid 的原生钩子中继记录视为不存在 [#128112](https://github.com/openclaw/openclaw/pull/128112)
- fix(plugin-sdk): 在 readBooleanParam 中读取 snake_case 键 [#131350](https://github.com/openclaw/openclaw/pull/131350)
- fix(http): 在关闭上传之前投递正文拒绝响应 [#131724](https://github.com/openclaw/openclaw/pull/131724)
- 为工具密集型运行添加 Codex 循环中继选择退出机制 [#97224](https://github.com/openclaw/openclaw/pull/97224)
- 补全插件会话目录契约 [dfa580e](https://github.com/openclaw/openclaw/commit/dfa580e)
- 保持 Plugin SDK expect 声明自包含 [feff4c7](https://github.com/openclaw/openclaw/commit/feff4c7)
- 解析大型模式数组中的有效本地引用 [#102195](https://github.com/openclaw/openclaw/pull/102195)
- 遵循显式为空的文档提取器范围 [#103731](https://github.com/openclaw/openclaw/pull/103731)
- fix(channels): 遵循空的目录文档前缀 [#103794](https://github.com/openclaw/openclaw/pull/103794)
- fix(ai): 拒绝非有限的工具模式数字 [#104470](https://github.com/openclaw/openclaw/pull/104470)
- 保留已弃用的 Plugin SDK 错误分类导出 [#104546](https://github.com/openclaw/openclaw/pull/104546)
- 让插件创作在其启动目录消失后仍能完成 [#106425](https://github.com/openclaw/openclaw/pull/106425)
- 在扩展命令输出中保留 Unicode 文本 [#108365](https://github.com/openclaw/openclaw/pull/108365)
- 让插件运行时补全请求推理 [#108759](https://github.com/openclaw/openclaw/pull/108759)
- 共享频道重试辅助程序并移除冗余的状态探针 [#108903](https://github.com/openclaw/openclaw/pull/108903)
- 验证受限的插件配置模式 [#109569](https://github.com/openclaw/openclaw/pull/109569)
- 在插件构建错误中显示格式错误的包路径 [#109916](https://github.com/openclaw/openclaw/pull/109916)
- 加固频道轮次生命周期边界 [#110406](https://github.com/openclaw/openclaw/pull/110406)
- 防止原生钩子中继截止时间竞争导致 CLI 失败 [#111413](https://github.com/openclaw/openclaw/pull/111413)
- 在规范化后的 SDK 事件 ID 中保留零值 [#113349](https://github.com/openclaw/openclaw/pull/113349)
- 每个钩子对仅解析一次入站认领会话身份 [#115491](https://github.com/openclaw/openclaw/pull/115491)
- 为已记录的 Plugin SDK 导入提供 TypeScript 声明 [#116345](https://github.com/openclaw/openclaw/pull/116345)
- 统一核心和 Control UI 中的 JSON Schema 验证 [#116622](https://github.com/openclaw/openclaw/pull/116622)
- 在 Discord 和 Slack 之间共享原生命令合并 [#120972](https://github.com/openclaw/openclaw/pull/120972)
- 将入站回复填充层保留到下一个 SDK 主版本 [#121922](https://github.com/openclaw/openclaw/pull/121922)
- 在整合强制转换辅助程序时忽略格式错误的新会话草稿 [#122020](https://github.com/openclaw/openclaw/pull/122020)
- 准确报告 ClickClack 媒体支持 [#126168](https://github.com/openclaw/openclaw/pull/126168)
- 整合媒体和进程运行时辅助程序 [#126490](https://github.com/openclaw/openclaw/pull/126490)
- fix(auto-reply): 将 chunkByNewline 中的尾部空行限制为块上限 [#127253](https://github.com/openclaw/openclaw/pull/127253)
- fix(protocol): 让聊天历史游标类型可消费 [#128018](https://github.com/openclaw/openclaw/pull/128018)
- fix(mcp): 从较早的消息中检索附件 [#131702](https://github.com/openclaw/openclaw/pull/131702)
- fix(gateway): 接受可空的插件审批元数据 [#133112](https://github.com/openclaw/openclaw/pull/133112)
文档
- 修正 beta 版 Plugin SDK 会话存储兼容性契约 [#105341](https://github.com/openclaw/openclaw/pull/105341)
- 添加 Gateway 客户端与嵌入式应用的指南 [#111726](https://github.com/openclaw/openclaw/pull/111726)
- 在翻译后的文档中保留字面名称 [6beb726](https://github.com/openclaw/openclaw/commit/6beb726)
- 在参考文档中保留精确的插件外部接口标识符 [ce07836](https://github.com/openclaw/openclaw/commit/ce07836)
- 将 Mattermost 和 Microsoft Teams 的仅测试导出设为私有 [#107924](https://github.com/openclaw/openclaw/pull/107924)
- 发布已弃用 Plugin SDK 路径的移除时间窗口 [#108035](https://github.com/openclaw/openclaw/pull/108035)
- 公布 Plugin SDK 子路径移除与降级窗口 [#108415](https://github.com/openclaw/openclaw/pull/108415)
- 更新保留的 Plugin SDK 门面(facades)的迁移指南 [#111535](https://github.com/openclaw/openclaw/pull/111535)
- 将插件设置弃用说明链接到迁移指南 [#112692](https://github.com/openclaw/openclaw/pull/112692)
- 修复 ACPX 设置指南中的 Copilot CLI 链接 [#114057](https://github.com/openclaw/openclaw/pull/114057)
- 澄清配对请求钩子仅用于观察 [#116055](https://github.com/openclaw/openclaw/pull/116055)
- 澄清哪个插件拥有入站消息认领权 [#116082](https://github.com/openclaw/openclaw/pull/116082)
- 记录插件关闭的排空截止时间 [#118099](https://github.com/openclaw/openclaw/pull/118099)
- docs(plugins):说明 factory tool 的 execute 签名 [#120097](https://github.com/openclaw/openclaw/pull/120097)
- 澄清 Codex 循环检测中继的安装时机 [#124918](https://github.com/openclaw/openclaw/pull/124918)
- [AI 辅助] docs(copilot):描述 transcript 日志,而非已移除的双写镜像 [#125599](https://github.com/openclaw/openclaw/pull/125599)
- 将插件根 CLI 命令与聊天命令分开记录 [#126621](https://github.com/openclaw/openclaw/pull/126621)
- docs(hooks):澄清命令日志记录器的存储 [#128478](https://github.com/openclaw/openclaw/pull/128478)
- docs(plugins):安装后 CLI 后端示例编译失败 [#129646](https://github.com/openclaw/openclaw/pull/129646)
- docs(hooks):澄清设置与执行契约 [#130734](https://github.com/openclaw/openclaw/pull/130734)
- docs(plugins):澄清已安装入口点的源回退机制 [#131640](https://github.com/openclaw/openclaw/pull/131640)
- docs(protocol):重建七月与八月的线上协议历史;新增 deferred-changes 章节 [#133063](https://github.com/openclaw/openclaw/pull/133063)
- 澄清仅 hook 插件的启动与运行时检查 [#77629](https://github.com/openclaw/openclaw/pull/77629)
**维护**
- 整合同级提供商适配器 [#117822](https://github.com/openclaw/openclaw/pull/117822)
</details>
插件包与宿主兼容性
OpenClaw 现在可以从目录、压缩包或 Git 源安装厂商中立的 Agent Plugins,加载其直接子技能以及有效的 stdio、HTTP 或 SSE MCP 服务器,并为它们提供有作用域的 bundle 和持久化数据路径。OpenClaw 扩展可以添加激活提示,而提供商、频道、配置模式和运行时入口点则不属于这一可移植 bundle 契约。无效的 MCP 条目会被跳过,不会阻塞有效的同级条目。
Cohere、Meta、BytePlus、ComfyUI、OpenCode、Voyage、Vydra、Volcengine、Mistral、NovitaAI、Teams 会议和 Zoom 会议现在以独立安装的 官方包 形式提供。新安装会安装相应包并重启 OpenClaw;已启用的现有安装会在外部产物可用时进行迁移。OpenCode Go 仍作为内置包提供,因为其外部占位项不可用。
插件加载现在可以处理 npm 10 至 12 的特定元数据和锁文件行为、直接及对等 OpenClaw 依赖、打包的主机运行时导入,以及此前导致已成功安装的插件无法激活的并发 Node ESM 场景。Canvas 现在专注于 macOS 演示者(presenter)和会话面板 A2UI 路径,其独立工作区、eval 和快照界面、原生 push 和 reset 命令,以及 iOS、Android 和 Linux 客户端均已移除。Dashboard 和 A2UI 操作仍然明确授权并受沙箱保护。
来源与完整变更列表
改进
- 为 Linux 桌面应用添加 Canvas 和 A2UI 支持 #107633
- 从类型化演示按钮启动托管微件 #108927
- 在 Control UI 和 Discord 中统一 show_widget #108983
- 为 Dashboard 微件提供已批准的网络和主机工具 #111687
- 将 Mistral 移至官方外部提供商插件 #116919
- 将 NovitaAI 外部化为官方提供商插件 #117007
- 将 OpenCode 移至官方外部提供商插件 #117035
- 将 OpenCode Go 移至官方外部插件目录 #117064
- 重新设计浏览器扩展弹出窗口 #118095
- 支持 Agent Plugins 捆绑包 #120115
- 为可移植 Agent Plugins 添加 OpenClaw 激活元数据 #120214
- 添加本地 Chrome 扩展自动设置 #121586
- 为受管理的 Codex 应用服务器添加预检检查 #124137
- 将 A2UI 应用作为会话面板微件运行 #125803
- 将 Canvas 重新定位为 macOS 微件演示者 #126030
- 添加一个 custodian 作用域的操作技能库 #126186
- feat(dashboard):让微件运行已授予的操作并打开链接 #127315
- 添加官方 Windows MXC 沙箱插件 #97086
- 为兼容 npm 12 替换 npm shrinkwrap #114006
- 将 Cohere 和 Meta 提供商移出核心包 #116662
- 将 Teams 和 Zoom 会议移至官方外部插件 #116682
- 将 DuckDuckGo 搜索移至按需官方插件 #116740
- 将 Voyage 嵌入移至外部插件 #116785
- 将 Vydra 从核心包移至官方外部插件 #116813
- 将 Volcengine 纳入官方外部提供商包 #116854
- 将 BytePlus 移至官方外部提供商插件 #116866
- refactor(plugins)!:移除 OpenProse #128494
- 停用实验性 Workspaces 插件 #110416
- 将内联微件托管移入核心 #110475
- 将 ComfyUI 外部化为官方提供商插件 #116888
- 从 Apps 页面链接到 Chrome Web Store 列表 #118327
Bug 修复
- 恢复 npm 12 上的插件元数据读取 #109699
- 恢复 Canvas 控件并强化已退役 Workspaces 的清理 #110927
- 恢复官方外部插件的主机运行时导入 #112021
- 为令牌认证的 Codex 运行恢复已连接应用 #115075
- fix(scripts): 构建堆忽略其 systemd 内存预算并使用全部默认值 #123979
- fix(openshell): 沙箱清理、工作区同步和网关设置失败问题 #129641
- 防止 Node 24 插件回退启动竞态 5839c2e
- 在启动工作前评估 Codex 应用服务器启动截止时间 6625ea9
- 恢复打包的 Codex sessions 命令 #102803
- 在源码构建的镜像中打包选定的外部插件 #103629
- 阻止静默的 Codex ACP 租约创建空的 stderr 日志 #106799
- 允许带有工作区依赖的 OCM 本地构建 #110426
- 当环境值为空时保留 MXC Windows 路径回退 #111077
- 防止打包的 macOS Settings 崩溃 #111300
- 为 Codex 已连接应用发现提供更多启动时间 #112418
- 保留用户主目录 Codex 应用服务器的原生认证 #114397
- 在不启用监督的情况下遵循用户主目录 Codex 设置 #114413
- 从 Node ESM require 竞态中恢复插件加载 #114618
- 阻止打包的 macOS Settings 崩溃 #114648
- 在服务会话中启用已配置的 Codex 应用 #115433
- 阻止 Diffs 指南提及不可用的工具 #115919
- 识别 Codex 的 API 精选插件市场名称 #115955
- 接受将已物化的技能目录作为沙箱工作目录 #116414
- 防止 Canvas 刷新风暴以及过期的续订计时器 #117173
- fix(ui): 限制沙箱主机中停滞的 widget 内容获取 #117363
- 恢复托管插件的主机运行时链接 #117408
- 从所有者清单生成官方渠道目录 #118097
- 修复预发布构建的 CUA 打包和 Slack 回退限制 #118103
- 刷新捆绑的渠道技能以适配当前工具和更安全的工作流 #119020
- 对齐 Fish Audio Speech 插件目录 #120084
- 保持 OpenCode Go 作为捆绑提供程序可用 #120985
- 执行打包的
.mjsCLI 回退 #121963 - 恢复可用 npm 安装的源码 Worker 捆绑包 #122430
- 解析捆绑插件新导出的 media-core 路径 #122523
- 在首次连接时唤醒本地 Chrome 扩展中继 #122537
- 恢复加载失败的捆绑插件视图 #122823
- 避免无会话运行的 Codex 转录警告 #122831
- 保持打包的 Zalo 设置向导可加载 #122902
- fix(dashboard): 通过主机而非沙箱弹出窗口打开 widget 链接 #128125
- fix(startup): 保留预加载的解析器钩子 #128663
- fix(sessions): 规范化包资源加载 #129098
- fix(skills): 安全加载受信任的 Bun 和 Nix 包硬链接 #129662
- chore(deps): 刷新已冷却七天的提供程序和原生工具 #130653
- fix(codex): 将托管运行时更新到 0.150.1 #130685
- 为打包的插件捆绑私有 SSRF 运行时 #96994
- 在 npm 包中发布 Crabbox 租约助手 28954c8
- 在截止时间后停止 Codex 启动阶段 c953d8e
- 将 Microsoft Teams 运行时入口点构建为原生 CommonJS #102366
- 保持 Codex 应用清单诊断的 UTF-16 安全性 #102414
- 保持 AI 包环境密钥加载对浏览器捆绑包安全 #102947
- 保留 Codex 诊断边界中的 Unicode #103740
- 恢复 Podman 上选定插件镜像的构建 #103814
- 防止过期的插件构建导致 Slack 启动崩溃 #104831
- 遵循捆绑命令调用策略 #105013
- fix(plugins): 向前移植捆绑 SDK 回退加固 #107131
- 对多字节 URI 强制执行 OC Path 限制 #108576
- 限制镜像构建期间的 Docker 签名密钥下载 #108894
- 修复 Codex 命令会话解析和预发布检查 #113820
- 按 JSON 结构比较插件元数据 #117486
- 忽略格式错误的插件构建版本元数据 #117639
- 链接将 OpenClaw 声明为直接依赖的插件 #117738
- fix(diffs): 恢复查看器路由上 GET/HEAD Content-Length 的一致性 #120280
- fix(diffs-language-pack): 在资源 HEAD 请求上提供字节准确的 Content-Length #120282
- 将与操作系统不兼容的常驻技能报告为不可用 #123731
- 将打包的外部插件条目保留在其运行时根目录内 #125173
- fix: 打包的 Crabbox 命令无需开发依赖即可运行 #125419
- 在不可变部署中保护插件覆盖层 #125902
- fix(oc-path): 为位置 JSONC 键添加引号 #130499
- fix(plugins): 源码依赖裁剪后原生导入失败 #131615
- fix(plugins): 保持检出插件上的开发运行 #132201
- fix(plugins): 在已构建的运行时上保留编译后的插件别名 #132545
- 在 Linux 上通过 CodexBar 启用模型用量统计 #87986
文档
- 将 Codex 应用发现文档更新为 app/installed [#115867](https://github.com/openclaw/openclaw/pull/115867)
- docs(mxc):隔离测试设置与清理 [#118945](https://github.com/openclaw/openclaw/pull/118945)
- 在 plugin-page 的发现提示中添加 Agent Plugins [#120323](https://github.com/openclaw/openclaw/pull/120323)
</details>
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw