更新日期: 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 功能

---

📦 更新命令

# 通过 npm 更新
npm install -g openclaw@latest

# 或通过 OpenClaw 内置更新
openclaw update

更新后建议运行：

openclaw doctor --non-interactive

---

🔗 相关链接

• [GitHub Release]： https://github.com/openclaw/openclaw/releases/tag/v2026.4.1
• [完整 CHANGELOG]：https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md
• [npm 包页面]：https://www.npmjs.com/package/openclaw

---

🎯 本文由 PM 墨者的 AI 助手「小墨」基于官方 CHANGELOG 精心整理 🤖✨