夜雨聆风标签：#OpenClaw #AI助手 #版本更新 #技术分享
🔥 更新亮点速览
⚠️【重要】破坏性变更详解
1️⃣ 节点执行架构变更
变更前：nodes.run "命令"变更后：exec host=node "命令"
📌 影响：所有使用 nodes.run 的自定义脚本都需要修改
2️⃣ 安全安装策略收紧
以前：危险代码警告但允许安装现在：危险代码检测失败 → 阻止安装
📌 解决方案：添加 --dangerously-force-unsafe-install 参数
3️⃣ 认证配置统一
不再支持混合认证方式必须选择一种认证方式并保持一致
4️⃣ 节点命令双重确认
设备配对 ✅ + 明确批准 ✅ = 使用节点命令
5️⃣ 插件SDK更新
淘汰旧版兼容路径保留openclaw/plugin-sdk/* 新入口
✨【惊喜】重磅新功能
🎯 QQ Bot 官方支持
终于来了！OpenClaw 原生支持 QQ：
• 🔐 多账号管理：同时管理多个QQ账号 • 🔒 安全存储：SecretRef 安全凭证管理 • ⌨️ 斜杠命令：便捷的命令操作 • ⏰ 提醒功能：定时提醒和通知 • 📁 媒体支持：图片、文件收发
🎨 LINE 媒体功能增强
现在支持完整的媒体发送：
📸 图片发送 → ✅🎬 视频发送 → ✅ 🎵 音频发送 → ✅👀 视频预览 → ✅⚡ 后台任务系统重构
旧系统：分散的任务管理新系统：统一的任务控制平面
优势：
• 📊 SQLite 任务台账 • 🔄 自动故障恢复 • 👁️ 任务状态可视化 • 🧹 智能清理机制
💬 Matrix 功能全面升级
• 📜 历史上下文：可配置的历史消息加载 • 🌐 代理支持：HTTP(S) 代理配置 • 🔄 流式回复：消息原地更新 • 🧵 线程隔离：更好的会话管理
🔧【实操】升级四步指南
📦 第一步：全面备份
# 备份配置文件cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.2026.3.28# 备份技能目录tar -czf ~/openclaw-skills-backup.tar.gz ~/.openclaw/skills/# 备份工作区（可选）tar -czf ~/openclaw-workspace-backup.tar.gz ~/.openclaw/workspace/🔍 第二步：兼容性检查
# 检查 nodes.run 使用情况find ~/.openclaw -type f -name "*.sh" -o -name "*.js" -o -name "*.py" | xargs grep -l "nodes\.run" 2>/dev/null# 运行健康诊断openclaw doctor --verbose# 检查插件兼容性openclaw plugins list --status🚀 第三步：执行升级
推荐方式（npm用户）：
npm update -g openclaw手动安装：
1. 访问：https://github.com/openclaw/openclaw/releases 2. 下载 v2026.3.31 安装包 3. 按照提示安装
✅ 第四步：验证升级
# 验证版本openclaw --version# 应该输出：openclaw 2026.3.31# 测试核心功能openclaw gateway statusopenclaw nodes statusopenclaw skills list# 运行快速测试openclaw --help🛡️【安全】增强功能详解
🔒 执行环境防护
新增防护项：
• 🚫 代理环境变量覆盖 • 🚫 TLS证书环境变量覆盖 • 🚫 Docker端点环境变量覆盖 • 🚫 Python包索引覆盖
保护效果：防止恶意脚本通过环境变量重定向网络流量或安装恶意包
🔐 认证安全升级
改进点：
• ⚡ 设备令牌轮换立即断开现有连接 • 🛡️ 共享认证速率限制增强 • 🌐 浏览器Origin头部严格验证
🚫 危险代码拦截
新策略：
• 🔍 安装时深度扫描 • ❌ 危险代码检测失败 → 阻止安装 • ⚠️ 需要显式确认才能安装危险插件
📱【修复】重要问题解决
Android 用户体验提升
修复问题：
• 📲 Android 15+ 设备信息读取 • 🔔 推送通知稳定性 • 🔗 设备配对流程优化
ACP 会话管理更可靠
改进点：
• 📝 子会话正确注册 • ⏸️ 任务阻塞状态持久化 • 🔄 父会话重定向更稳定
配置迁移更平滑
优化项：
• 🤖 Telegram 配置自动迁移 • 🔐 SecretRef 安全恢复 • ⚙️ 插件默认值处理
📊【性能】优化效果
内存管理优化 🧠
改进：
• 🎯 按需加载会话历史 • 🔍 搜索更精准高效 • 💾 避免内存浪费
界面渲染优化 👁️
提升：
• ⚡ 大文件差异查看速度 • 🎨 减少不必要的渲染 • 🌐 语言提示更智能
🎯【建议】升级策略
✅ 推荐立即升级
适合人群：
• 🔐 注重数据安全的用户 • 🇨🇳 使用 QQ 的国内用户 • 🇯🇵 使用 LINE 的日本用户 • 📱 Android 设备用户 • ⏰ 依赖后台任务的用户
⏸️ 建议先测试再升级
谨慎情况：
• 📜 大量自定义脚本 • 🏭 生产环境关键系统 • 🔌 使用旧版插件 • 🤖 复杂自动化流程
🔧 升级后检查清单
• 节点脚本功能正常 • 插件全部可用 • 认证登录顺畅 • 后台任务稳定 • 媒体功能正常 • 通知推送正常
❓【问答】常见问题
Q1：升级失败如何回滚？
# 回滚到 v2026.3.28npm install -g openclaw@2026.3.28# 恢复备份配置cp ~/.openclaw/openclaw.json.backup.2026.3.28 ~/.openclaw/openclaw.jsonQ2：nodes.run 脚本如何迁移？
旧脚本：
nodes.run "ls -la /path"新脚本：
exec host=node "ls -la /path"Q3：危险插件无法安装怎么办？
# 添加危险安装参数openclaw skills install 插件名 --dangerously-force-unsafe-installQ4：升级需要多长时间？
通常情况：5-10分钟影响因素：网络速度、系统性能、数据量大小
📞【支持】获取帮助
官方资源
• 📚 文档中心：https://docs.openclaw.ai • 🐙 GitHub：https://github.com/openclaw/openclaw • 💬 Discord：https://discord.com/invite/clawd
社区支持
• 🎯 技术论坛：相关开发者社区 • 🤝 用户群组：Telegram、微信等用户群 • 📝 博客教程：技术博客和教程分享
问题反馈
1. 查看现有 Issues 2. 提交新 Issue 3. 提供详细的重现步骤 4. 附上日志和配置信息
🎉【总结】更新价值
👍 升级带来的好处
1. 安全性大幅提升 - 多项安全加固 2. 功能更加丰富 - QQ Bot 等新功能 3. 稳定性更好 - 50+ 问题修复 4. 性能有所优化 - 内存和渲染优化 5. 用户体验改善 - 多个细节优化
👎 需要注意的事项
1. 破坏性变更 - 需要适配修改 2. 兼容性问题 - 部分旧插件需要更新 3. 学习成本 - 新功能需要时间熟悉
💡 最终建议
个人用户：可以立即升级，享受新功能企业用户：建议先测试环境验证开发者：需要检查插件和脚本兼容性
🚨 重要提醒：无论什么情况，升级前务必备份数据！安全第一，预防为主。
如果觉得有帮助，欢迎点赞、转发、收藏。你的支持是我持续分享的动力！