Gateway Upgrade Local Fork

这是OpenClaw网关服务本地fork升级工具，覆盖预检、备份、升级、env合并、验证全流程，可解决升级时自定义环境变量（如CUDA路径）丢失问题，串行重建索引避免锁争用，检查GPU加速状态。适用于用户主动升级、服务异常、env丢失、GPU误判等场景，所有操作本地完成，无数据转发，支持紧急回滚。

热度 16.10

最近更新 2026-06-05 10:43:18

分类：自动化依赖：代码执行 / 读写文件应用场景：DevOps / 自动化脚本 / 任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add gateway-upgrade-local-fork

Metadata

name: gateway-upgrade-local-fork
version: 0.3.0
description: OpenClaw 网关服务本地 fork 升级 skill。覆盖 backup → upgrade → env-merge → verify 全流程。专门处理 OpenClaw systemd service 升级时丢失 user 自定义环境变量（CUDA / LD_LIBRARY_PATH / QMD_EMBED_MODEL）的问题，跑 qmd doctor 检查 RTX 30/40 系 GPU 加速状态，串行重建 per-agent qmd 索引避免 batch embed lock 争用。No data forwarded; all operations are local service+db manipulation only.
metadata: {"openclaw":{"emoji":"⬆️","requires":{"anyBins":["systemctl","sqlite3","node"]}}}

升级 OpenClaw 主程序端到端 skill。大方向按 5 阶段跑：

详细流程 → 各自 references 文档。

阶段	文档	关键点
0. Pre-flight	references/01-preflight.md	service unit .bak + qmd doctor baseline + GPU 状态
1. Backup	references/02-backup.md	binary + service + dbs（核心：env 备份）
2. Upgrade	references/03-upgrade.md	跑升级 + 手动合并 user env（关键）
3. Post-flight	references/04-postflight.md	diff env 找丢失的 + Description 跟 version 一致
4. Verify	references/05-verify.md	qmd doctor + memory_search + per agent serial rebuild
紧急回滚	references/06-rollback.md	完全跑不起来的回滚步骤
注意事项	references/80-notes.md	一些容易踩的点（不是 silent failure 之王）

脚本	用途
`scripts/backup-env.sh`	一键备份 service unit + binary + per agent dbs
`scripts/diff-env.sh`	diff 当前 service 跟 .bak，列丢失的 user env
`scripts/qmd-rebuild-serial.sh`	串行重建 per agent qmd index（不并发）
`scripts/upgrade-report.sh`	输出升级报告模板