标签:#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. 学习成本 - 新功能需要时间熟悉
💡 最终建议
个人用户:可以立即升级,享受新功能企业用户:建议先测试环境验证开发者:需要检查插件和脚本兼容性
🚨 重要提醒:无论什么情况,升级前务必备份数据!安全第一,预防为主。
如果觉得有帮助,欢迎点赞、转发、收藏。你的支持是我持续分享的动力!
夜雨聆风