An advanced automation agent skill to seamlessly coordinate, validate, and document Mingdao Cloud HAP private deployment version upgrades.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hap-upgrade-guide
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install hap-upgrade-guide using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is HAP Private Deployment Upgrade Guide?
The HAP Private Deployment Upgrade Guide skill provides deep automation for managing complex platform upgrades on Mingdao Cloud (HAP). Upgrading self-hosted systems often involves tedious tasks such as verifying system architectures, merging multi-version SQL/NoSQL schema migrations, and configuring microservices. This skill eliminates human error by dynamically retrieving official version matrices and compiling highly customized, executable step-by-step Standard Operating Procedures (SOPs).
By leveraging Openclaw Skills, devops teams can instantly generate comprehensive upgrade scripts, validate architecture compatibilities (AMD64 vs. ARM64), handle multi-image splits (such as the v5.1.0 architectural change), and execute major database updates (like MongoDB 3.4 to 4.4 migrations). It even produces localized standalone HTML installation manuals complete with responsive tables of contents and code-copy capabilities, ensuring zero-downtime execution accuracy.
HAP Private Deployment Upgrade Guide Use Cases
- Verifying if a specific Mingdao Cloud HAP deployment version can be upgraded to a target version.
- Automatically gathering configuration inputs (architecture, networking environment, and single vs. cluster mode) to construct a localized upgrade playbook.
- Executing cross-version transitions requiring composite pre-upgrade operations, such as MongoDB index rebuilds or storage module configurations.
- Generating standard compliance documents and standalone HTML upgrade manuals for air-gapped or offline private cloud instances.
- Handling critical structural adjustments, such as microservice image splits or standard S3/MinIO file initialization (fileInit) migrations.
How HAP Private Deployment Upgrade Guide Works
- Information Gathering: The skill checks for five critical deployment attributes (current version, target version, architecture, network status, single/cluster mode) and prompts follow-up questions to fill any gaps.
- Version Normalization & Scrapping: Normalizes the versioning inputs (e.g., standardizing display v-tags) and crawls the live official manifest (https://docs-pd.mingdao.com/version) to extract upgrade paths.
- Architecture Compatibility Validation: Instantly verifies container image compatibility for AMD64/ARM64 and aborts safely if the target version lacks official support.
- Instruction Merging & Sequencing: Scrapes upgrade micro-docs to synthesize pre-upgrade configurations and post-upgrade data migrations, applying strict chronologically sorted merge-rules.
- SOP Compilation: Populates customized Markdown templates with actual system values, microservice environment variables (ENV_APP_VERSION), and localized offline/online asset URLs.
- HTML Transformation: Auto-renders the finalized Markdown into a responsive, single-page offline HTML package containing structured sidebars, auto-collapsible navigation tables, and clipboards.
HAP Private Deployment Upgrade Guide Setup
To run this skill, ensure your AI agent environment has access to the local templates and reference lists under references/ and assets/ directories.
1. Structure the Project Directory
Create the following files in your workspace:
mkdir -p references assets
Place the merge-rules.md, command-library.md, and site-structure.md in the references/ directory. Place upgrade-guide-template-standalone.md and upgrade-guide-template-cluster.md in assets/.
2. Configure Environment Access
Make sure the system has external internet access to scrape Mingdao's official documentation hub:
curl -I https://docs-pd.mingdao.com/version
3. Initialize the Skill
Inside your Openclaw Skills agent, register the skill definition. When prompted with any query containing 'HAP upgrade', the agent automatically executes this script pipeline to evaluate your environment.
HAP Private Deployment Upgrade Guide Data Schema & Taxonomy
This skill adheres to a strict naming taxonomy and produces two output files per generation task.
Output Naming Convention
Files are created in the current working directory following this pattern:
HAP升级指南-v{current_version}-to-v{target_version}-{mode}.mdHAP升级指南-v{current_version}-to-v{target_version}-{mode}.html
Where {mode} is either 单机 (Single-node) or 集群 (Cluster).
Workspace Metadata Schema
| Directory | File Name | Role / Purpose |
|---|---|---|
| references/ | site-structure.md | Contains structural patterns and documentation crawling endpoints. |
| references/ | merge-rules.md | Logic dictates how to combine database DDL changes and configuration updates. |
| references/ | command-library.md | Stores raw bash commands for standalone and clustered instances across architectures. |
| assets/ | upgrade-guide-template-standalone.md | Master Markdown template for Docker Compose environments. |
| assets/ | upgrade-guide-template-cluster.md | Master Markdown template for Kubernetes / Swarm environments. |
Generated HTML Structure
The output HTML embeds a highly organized metadata block (containing the upgrade path, node type, target CPU architecture, and generation date) followed by interactive collapsible script blocks for pre-upgrade, microservices upgrade, and post-upgrade procedures.
HAP Private Deployment Upgrade Guide Advanced Features
- Automated Database Schema Merging: Combines multiple schema modifications (MySQL and MongoDB DDLs) across several sequential versions into a single, optimized transactional execution step.
- Complex Migration Workflows: Automatically injects full structural automation details, such as splitting the mingdaoyun-community image into separate sc and command nodes for v5.1.0 upgrades.
- Intelligent Offline/Air-Gapped Adaptations: Dynamic detection of offline networks automatically swaps raw container registry requests for direct tarball download URLs of official microservices (e.g., standardizing mingdaoyun-doc offline packages).
- MongoDB Re-indexing Automations: Injects complete, robust JavaScript procedures directly into the generated SOPs to safely run multi-database reIndex() operations during major engine upgrades (v3.4 to v4.4).
- Adaptive fileInit Orchestrator: Identifies deployment files storage backends (File v1 vs. File v2 with standard S3/MinIO) and generates conditional execution options (fileInit vs s3fileInit).
SKILL.md
Loading
Related Openclaw Skills
Mimic My Writing
Mimic My Writing extracts mathematical voice fingerprints from human text to prevent generic AI style defaults and enforce genuine, human-like drafting.
Alipay API Integration Skill
An Openclaw skill that equips AI agents with the capability to interface directly with Alipay (支付宝) APIs for financial operations.
refire
A structured, chef-inspired debugging workflow for AI agents to analyze, reproduce, and resolve codebase bugs at their root cause without guessing.
Reduce Code Complexity Skill
A developer-focused skill designed to boil off excess complexity, reveal intent, and clean up code while strictly preserving original behavior.
DingTalk Shanji Minutes Extractor
An AI-ready command-line automation skill for extracting meeting minutes, summaries, and transcripts from DingTalk Shanji.
Wang Xiaobo Style Writing Assistant
A structured writing assistant designed to teach and generate Chinese essays in the analytical, logical, and humorous style of Chinese essayist Wang Xiaobo.
Featured*
