OpenClaw 升级前影响评估工具

自动分析 OpenClaw 官方更新对你的配置和备份系统的影响，生成详细报告并自动备份。

🎯 功能

• 🔍 获取官方最新版本更新内容
• 📊 分析更新对现有配置的影响
• ✅ 检查备份系统完整性
• 📝 生成详细影响分析报告
• 🔄 自动备份受影响的配置文件
• ⚠️ 提供升级建议和注意事项

🤝 与其他 Update 技能的关系

我们不做:

• ❌ 不执行 OpenClaw 更新
• ❌ 不自动更新技能包
• ❌ 不修改系统配置

我们专注:

• ✅ 升级前深度影响分析
• ✅ 配置兼容性评估
• ✅ 精准备份受影响文件
• ✅ 生成详细升级建议

完美互补:

• 先用 openclaw-update-checker 分析影响
• 再用 Openclaw Update 执行更新
• 安全 + 可靠！

典型使用场景:

// 步骤 1: 分析影响（我们的技能）
const analysis = await openclaw.updateChecker.analyze();
if (analysis.compatibilityCheck.high === 0) {
  console.log('✅ 可以安全升级');
  
  // 步骤 2: 执行更新（使用 Openclaw Update 等工具）
  // openclaw update
}

🚀 使用示例

基础用法

// 检查官方更新影响
const result = await openclaw.updateChecker.analyze();
console.log(result.report);

完整用法

// 分析更新影响并生成报告
const analysis = await openclaw.updateChecker.analyze({
  currentVersion: '2026.3.13',  // 当前版本（可选，自动检测）
  targetVersion: 'latest',       // 目标版本（可选，默认 latest）
  backupAffected: true,          // 是否备份受影响的文件（可选，默认 true）
  generateReport: true,          // 是否生成报告（可选，默认 true）
  outputPath: './update-impact-report.md'  // 报告输出路径（可选）
});

// 输出分析结果
console.log('影响评估:', analysis.impactSummary);
console.log('需要关注的文件:', analysis.affectedFiles);
console.log('升级建议:', analysis.recommendations);

检查特定配置文件

// 检查特定配置文件的兼容性
const configCheck = await openclaw.updateChecker.checkConfig({
  files: ['AGENTS.md', 'HEARTBEAT.md', 'scripts/*.js'],
  version: '2026.3.23'
});

生成备份

// 备份当前配置
const backup = await openclaw.updateChecker.backup({
  destination: './backup/update-20260324',
  includeAffectedOnly: true  // 只备份受影响的文件
});

📋 工作流程

1. 获取版本信息

   • 检测当前安装的 OpenClaw 版本
   • 获取官方最新版本信息
   • 读取 GitHub Release 更新日志

2. 分析更新内容

   • 解析 Breaking Changes
   • 识别配置变更
   • 标记废弃功能
   • 记录新增功能

3. 检查本地配置

   • 扫描工作区配置文件
   • 对比更新影响范围
   • 识别潜在兼容性问题

4. 生成影响报告

   • 高优先级问题（必须处理）
   • 中优先级问题（建议处理）
   • 低优先级问题（需要注意）
   • 无影响项目（完全兼容）

5. 自动备份

   • 备份受影响的配置文件
   • 创建版本快照
   • 记录备份清单

6. 提供建议

   • 升级步骤
   • 升级后检查清单
   • 回滚方案

📊 输出示例

# OpenClaw 更新影响分析报告

**分析时间**: 2026-03-24 11:09
**当前版本**: v2026.3.13
**目标版本**: v2026.3.23

## 影响评估

### 🔴 高优先级（必须处理）
- 无

### 🟡 中优先级（建议处理）
- 飞书媒体附件配置 - 官方已修复发送失败问题
- Exec 安全审批规则变更 - 可能需要重新审批命令

### 🟢 低优先级（需要注意）
- 浏览器 CDP 配置 - 官方优化复用逻辑
- 插件 SDK 路径变更 - 不影响最终用户

## 兼容性统计

| 类别 | 文件数 | 兼容性 |
|------|--------|--------|
| 核心配置 | 7 | ✅ 100% |
| 技能包 | 100+ | ✅ 100% |
| 自动化脚本 | 15+ | ✅ 100% |
| 文档 | 10 | ✅ 100% |

## 升级建议

1. 可以安全升级到 v2026.3.23
2. 升级后测试飞书图片发送
3. 检查浏览器连接是否正常
4. 关注 Exec 审批日志

## 备份清单

✅ 已备份 13 个文件到 ./backup/update-20260324

⚙️ 配置

在 openclaw.json 中添加配置：