在明道云 HAP 私有化部署的运维实践中，跨版本升级远不只是简单的镜像替换。实际操作中，往往还涉及：
- 数据库 SQL 变更（MySQL DDL）
- MongoDB 预置数据更新
- 环境变量与部署参数调整
- 特定版本的附加操作说明
随着版本持续迭代，跨多个版本升级时，变更点会不断叠加。若依赖人工逐条翻阅官方文档并整理操作步骤，不仅耗时耗力，还极易遗漏关键细节，进而引发升级异常甚至系统故障。
为解决这一问题，现分享 HAP 升级助手（hap-upgrade）Skill。
借助 OpenClaw 的自动化能力，系统化梳理跨版本变更内容，生成结构清晰、步骤完整的升级指南，让升级过程更加安全、可控。
使用方式
第一步：安装 Skill
在 OpenClaw 中安装本 Skill：
https://clawhub.ai/wuyanfeiwork/hap-upgrade
第二步：发送升级指令
向 OpenClaw 发送类似指令即可：
帮我整理 HAP 私有部署版 v6.4.0 升级到 v7.2.0 的指南。
第三步：确认环境信息并生成手册
OpenClaw 会主动询问必要的部署信息，例如：
- 部署模式（单机 / 集群）
- 系统架构（AMD64 / ARM64）
- 服务器是否可联网
在确认环境参数后，系统将自动检索官方文档，合并各版本之间的变更说明，梳理所有附加操作，最终输出一份 专属于您当前部署环境的 Markdown 格式升级手册。
效果展示
在企业微信中下发任务
在 WorkBuddy 中下发任务
文档内容由 AI 生成。尽管已尽力确保信息的准确性与完整性，但仍可能存在不准确、过时或偏差情况。在执行关键操作前，请务必对照官方文档进行核实。
