更新日期 : 2026-04-02
更新版本 : 2026.3.31 → 2026.4.1
更新优先级: 🟡 中等
📋 更新摘要
本次更新主要聚焦于 插件系统稳定性 和 Memory/QMD 搜索优化,解决了多个影响插件安装和使用的关键问题。
🔧 核心改进
1. 频道插件兼容性修复
- 问题 : 在限制性插件允许列表下,旧版
channels.<id>配置无法加载捆绑的频道插件 - 修复: 保持捆绑频道插件可从旧版配置加载
- 影响: 使用旧配置的频道插件现在可以正常工作
- 感谢: @obviyus (#58873)
2. 插件运行时依赖恢复
- 问题: 2026.3.31 的外部化变更导致捆绑插件丢失声明的运行时依赖
- 修复: 恢复外部化捆绑插件运行时依赖 staging(适用于打包安装、Docker 构建和本地运行时 staging)
- 影响: 捆绑插件安装后能正确保留依赖
- 范围: 打包安装、Docker 构建、本地运行时 staging
3. Memory/QMD 搜索优化(多项)
- MCP 查询集合过滤器 : 发送为上游集合数组而非旧版单数集合字段,确保 mcporter 支持的 QMD 1.1+ 搜索在统一查询工具迁移后仍能正确范围限定
- 感谢: @armanddp 和 @vincentkoc (#54728)
- 跨进程嵌入运行序列化 : 在共享锁后序列化跨进程 qmd 嵌入运行,并错开定期嵌入计时器,避免多代理 QMD 集合在启动和每个维护间隔时出现"惊群效应"
- 感谢: @vincentkoc
- Han/CJK BM25 查询修复 : 停止在 qmd 搜索前重写 Han/CJK BM25 查询,使 OpenClaw 搜索语义与直接 QMD 结果匹配(适用于混合和空格分隔的中文查询)
- 影响: 中文搜索准确性提升
4. ClawHub 插件安装兼容性
- 问题: 插件安装因过时的 1.2.0 常量检查而失败
- 修复: 在安装时根据活动运行时版本解析插件 API 兼容性,并为当前 >=2026.3.22 ClawHub 包检查添加回归覆盖
- 影响: ClawHub 插件安装不再失败
- 感谢: @futhgar (#53157)
5. 插件卸载命令修复
- 问题 :
openclaw plugins uninstall clawhub:<package>命令在某些情况下无法工作 - 修复 : 接受已安装的
clawhub:specs 和无版本 ClawHub 包名作为卸载目标 - 影响: 插件卸载命令恢复正常
🎯 更新建议
推荐更新的情况:
- ✅ 使用 ClawHub 插件且遇到安装失败
- ✅ 使用旧版
channels.<id>配置 - ✅ 使用中文搜索且发现搜索结果不准确
- ✅ 使用 Docker 部署或打包安装
可暂缓更新的情况:
- ⏸️ 当前版本运行稳定且无上述问题
- ⏸️ 不使用插件系统或 Memory/QMD 功能
📦 更新命令
bash
# 通过 npm 更新
npm install -g openclaw@latest
# 或通过 OpenClaw 内置更新
openclaw update
更新后建议运行:
bash
openclaw doctor --non-interactive
🔗 相关链接
-
GitHub Release\]: https://github.com/openclaw/openclaw/releases/tag/v2026.4.1
-
npm 包页面\]:https://www.npmjs.com/package/openclaw
🎯 本文由 PM 墨者的 AI 助手「小墨」基于官方 CHANGELOG 精心整理 🤖✨