全部技能 分类浏览
← 返回
未分类

gateway-upgrade-local-fork

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.
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.
yjkj999999
未分类 community v1.0.0 1 版本 100000 Key: 无需
★ 0
Stars
📥 13
下载
💾 0
安装
1
版本
#latest

概述

OpenClaw Upgrade

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

  1. Pre-flight — 体检当前状态，建立 baseline
  2. Backup — 完整回滚点
  3. Upgrade — 跑升级 + 合并 user env
  4. Post-flight — diff env，确认没漏
  5. Verify — 健康检查 + 修复

详细流程 → 各自 references 文档。

阶段文档关键点
--------------------
0. Pre-flightreferences/01-preflight.mdservice unit .bak + qmd doctor baseline + GPU 状态
1. Backupreferences/02-backup.mdbinary + service + dbs（核心：env 备份）
2. Upgradereferences/03-upgrade.md跑升级 + 手动合并 user env（关键）
3. Post-flightreferences/04-postflight.mddiff env 找丢失的 + Description 跟 version 一致
4. Verifyreferences/05-verify.mdqmd 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.shdiff 当前 service 跟 .bak，列丢失的 user env
scripts/qmd-rebuild-serial.sh串行重建 per agent qmd index（不并发）
scripts/upgrade-report.sh输出升级报告模板

核心原则（记住这 5 条就够了）

  1. 先备份再动手 — 任何升级前必须有可回滚点
  2. env 是最容易丢的 — service unit 升级时不保留 user 自定义 env
  3. service 跟 user shell GPU 资源不同 — LD_LIBRARY_PATH / CUDA_HOME 必须显式设
  4. per agent rebuild 不要并发 — 抢 batch embed lock + GPU = timeout 砍
  5. 大版本升级前看 changelog — qmd 跳 0.1.x → 2.0 / 2.5 是 silent ABI mismatch 高发期

触发场景

  • user 喊"升级 OpenClaw" / "5.28 → 6.0" / "升级 5.28"
  • 5.28 service 跑得不对劲（memory_search 报错 / agent timeout）
  • qmd 报错 ABI mismatch / Dimension mismatch / better_sqlite3.node 找不到
  • service unit 升级后 user 自定义 env 丢失
  • nvidia-smi 找不到但实际 GPU 在（WSL2 误判）

版本历史

共 1 个版本

  • v1.0.0 从ClawHub迁移发布 当前
    2026-06-07 12:46 安全 安全

安全检测

腾讯云安全 (Keen)

安全，无风险
查看报告

腾讯云安全 (Sanbu)

安全，无风险
查看报告

🔗 相关推荐

it-ops-security

1password

steipete
设置和使用 1Password CLI (op)。适用于：安装 CLI、启用桌面应用集成、登录（单/多账户）、通过 op 读取/注入/运行密钥。
★ 53 📥 31,956
it-ops-security

Free Ride - Unlimited free AI

shaivpidadi
管理OpenClaw的OpenRouter免费AI模型，自动按质量排名模型，配置速率限制备用方案，并更新opencla...
★ 472 📥 78,761
design-media

agnes-image-gen

user_15292d5a
使用 Agnes AI 的图片生成模型生成图片，支持文生图（agnes-image-2.1-flash）和图生图（agnes-image-2.0-flash）。支持自定义 API Key，用户可使用自己的 Agnes Key。优化重点：降低
★ 1 📥 250

Skill工具集 © 2026