{
  "schemaVersion": "1.0",
  "item": {
    "slug": "phoenix-sheld",
    "name": "Phoenix Shield",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/yiqiezhenxi/phoenix-sheld",
    "canonicalUrl": "https://clawhub.ai/yiqiezhenxi/phoenix-sheld",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/phoenix-sheld",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phoenix-sheld",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/phoenix-sheld"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/phoenix-sheld",
    "agentPageUrl": "https://openagent3.xyz/skills/phoenix-sheld/agent",
    "manifestUrl": "https://openagent3.xyz/skills/phoenix-sheld/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/phoenix-sheld/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "PhoenixShield 🔥🛡️",
        "body": "\"Like the Phoenix, your system rises from its own backup\"\n\nSelf-healing backup and update system with intelligent rollback capabilities."
      },
      {
        "title": "Why PhoenixShield?",
        "body": "Problem: System updates can fail, leaving services broken and causing downtime.\n\nSolution: PhoenixShield provides a complete safety net with automatic rollback when things go wrong.\n\nBenefits:\n\n🔄 Automatic Recovery - Self-heals when updates fail\n🧪 Canary Testing - Test updates before production\n📊 Health Monitoring - 24h post-update monitoring\n⚡ Smart Rollback - Only revert changed components\n🛡️ Zero-Downtime - Graceful degradation when possible"
      },
      {
        "title": "1. Initialize PhoenixShield",
        "body": "phoenix-shield init --project myapp --backup-dir /var/backups"
      },
      {
        "title": "2. Create Pre-Update Snapshot",
        "body": "phoenix-shield snapshot --name \"pre-update-$(date +%Y%m%d)\""
      },
      {
        "title": "3. Safe Update with Auto-Recovery",
        "body": "phoenix-shield update \\\n  --command \"npm update\" \\\n  --health-check \"curl -f http://localhost/health\" \\\n  --auto-rollback"
      },
      {
        "title": "4. Monitor Post-Update",
        "body": "phoenix-shield monitor --duration 24h --interval 5m"
      },
      {
        "title": "1. Pre-Flight Checks",
        "body": "Before any update, PhoenixShield verifies:\n\nphoenix-shield preflight\n\nChecks:\n\n✅ Disk space available\n✅ No critical processes running\n✅ Backup storage accessible\n✅ Network connectivity\n✅ Service health baseline"
      },
      {
        "title": "2. Intelligent Backup",
        "body": "# Full system snapshot\nphoenix-shield backup --full\n\n# Incremental (only changed files)\nphoenix-shield backup --incremental\n\n# Config-only backup\nphoenix-shield backup --config\n\nBackup includes:\n\nConfiguration files\nDatabase dumps\nSystem state\nProcess list\nNetwork connections\nHealth metrics baseline"
      },
      {
        "title": "3. Canary Deployment",
        "body": "Test updates on isolated environment first:\n\nphoenix-shield canary \\\n  --command \"apt upgrade\" \\\n  --test-duration 5m \\\n  --test-command \"systemctl status nginx\""
      },
      {
        "title": "4. Production Update",
        "body": "Execute update with safety net:\n\nphoenix-shield deploy \\\n  --command \"npm install -g openclaw@latest\" \\\n  --health-checks \"openclaw --version\" \\\n  --health-checks \"openclaw health\" \\\n  --rollback-on-failure"
      },
      {
        "title": "5. Post-Update Monitoring",
        "body": "Automatic monitoring stages:\n\nTimeframeChecks0-5 minCritical services running5-30 minAll services responding30-120 minIntegration tests2-24hStability monitoring\n\nphoenix-shield monitor --start"
      },
      {
        "title": "6. Smart Rollback",
        "body": "When update fails, PhoenixShield:\n\nAttempts soft recovery - Restart services\nConfig rollback - Revert configuration\nPackage rollback - Downgrade packages\nFull restore - Complete system restore\nEmergency mode - Minimal services, notify admin\n\n# Manual rollback\nphoenix-shield rollback --to-snapshot \"pre-update-20260205\"\n\n# Check what would be rolled back (dry run)\nphoenix-shield rollback --dry-run"
      },
      {
        "title": "Safe OpenClaw Update",
        "body": "#!/bin/bash\n# Update OpenClaw with PhoenixShield protection\n\nphoenix-shield preflight || exit 1\n\nphoenix-shield snapshot --name \"openclaw-$(date +%Y%m%d)\"\n\nphoenix-shield deploy \\\n  --command \"npm install -g openclaw@latest && cd /usr/lib/node_modules/openclaw && npm update\" \\\n  --health-check \"openclaw --version\" \\\n  --health-check \"openclaw doctor\" \\\n  --rollback-on-failure\n\nphoenix-shield monitor --duration 2h"
      },
      {
        "title": "Ubuntu Server Update",
        "body": "phoenix-shield deploy \\\n  --command \"apt update && apt upgrade -y\" \\\n  --health-check \"systemctl status nginx\" \\\n  --health-check \"systemctl status mysql\" \\\n  --pre-hook \"/root/notify-start.sh\" \\\n  --post-hook \"/root/notify-complete.sh\" \\\n  --auto-rollback"
      },
      {
        "title": "Multi-Server Update",
        "body": "# Update multiple servers with PhoenixShield\nSERVERS=\"server1 server2 server3\"\n\nfor server in $SERVERS; do\n  phoenix-shield deploy \\\n    --target \"$server\" \\\n    --command \"apt upgrade -y\" \\\n    --batch-size 1 \\\n    --rollback-on-failure\ndone"
      },
      {
        "title": "Configuration",
        "body": "Create phoenix-shield.yaml:\n\nproject: my-production-app\nbackup:\n  directory: /var/backups/phoenix\n  retention: 10  # Keep last 10 backups\n  compression: gzip\n\nhealth_checks:\n  - command: \"curl -f http://localhost/health\"\n    interval: 30s\n    retries: 3\n  - command: \"systemctl status nginx\"\n    interval: 60s\n\nmonitoring:\n  enabled: true\n  duration: 24h\n  intervals:\n    critical: 1m    # 0-5 min\n    normal: 5m      # 5-30 min\n    extended: 30m   # 30-120 min\n    stability: 2h   # 2-24h\n\nrollback:\n  strategy: smart  # smart, full, manual\n  auto_rollback: true\n  max_attempts: 3\n\nnotifications:\n  on_start: true\n  on_success: true\n  on_failure: true\n  on_rollback: true"
      },
      {
        "title": "Commands Reference",
        "body": "CommandDescriptioninitInitialize PhoenixShield for projectsnapshotCreate system snapshotbackupCreate backup (full/incremental)preflightRun pre-update checkscanaryTest update in isolated environmentdeployExecute update with protectionmonitorStart post-update monitoringrollbackRollback to previous statestatusShow current statushistoryShow update historyverifyVerify backup integrity"
      },
      {
        "title": "Integration with CI/CD",
        "body": "# GitHub Actions example\n- name: Safe Deployment\n  run: |\n    phoenix-shield preflight\n    phoenix-shield snapshot --name \"deploy-$GITHUB_SHA\"\n    phoenix-shield deploy \\\n      --command \"./deploy.sh\" \\\n      --health-check \"curl -f http://localhost/ready\" \\\n      --auto-rollback"
      },
      {
        "title": "1. Always Use Preflight",
        "body": "# Bad\nphoenix-shield deploy --command \"apt upgrade\"\n\n# Good\nphoenix-shield preflight && \\\nphoenix-shield deploy --command \"apt upgrade\""
      },
      {
        "title": "2. Test Rollback Before Production",
        "body": "phoenix-shield snapshot --name test\nphoenix-shield deploy --command \"echo test\"\nphoenix-shield rollback --dry-run  # See what would happen"
      },
      {
        "title": "3. Monitor Critical Updates",
        "body": "phoenix-shield deploy --command \"major-update.sh\"\nphoenix-shield monitor --duration 48h  # Extended monitoring"
      },
      {
        "title": "4. Maintain Backup Hygiene",
        "body": "# Regular cleanup\nphoenix-shield cleanup --keep-last 10 --older-than 30d\n\n# Verify backups\nphoenix-shield verify --all"
      },
      {
        "title": "\"Preflight check failed\"",
        "body": "Check disk space: df -h\nVerify backup location exists\nEnsure no critical processes running"
      },
      {
        "title": "\"Rollback failed\"",
        "body": "Check backup integrity: phoenix-shield verify\nManual restore from: /var/backups/phoenix/\nContact admin for emergency recovery"
      },
      {
        "title": "\"Health checks failing\"",
        "body": "Extend monitoring: phoenix-shield monitor --duration 48h\nCheck service logs: journalctl -u myservice\nConsider partial rollback: phoenix-shield rollback --config-only"
      },
      {
        "title": "Architecture",
        "body": "┌─────────────────────────────────────┐\n│        PhoenixShield Core           │\n├─────────────────────────────────────┤\n│ PreFlight │ Deploy │ Monitor │ Roll │\n├─────────────────────────────────────┤\n│   Backup Engine  │  Health Engine   │\n├─────────────────────────────────────┤\n│      Snapshots   │   Recovery       │\n├─────────────────────────────────────┤\n│   Config │ State │ Logs │ Metrics   │\n└─────────────────────────────────────┘"
      },
      {
        "title": "Security",
        "body": "Backups are encrypted at rest\nIntegrity verification with checksums\nSecure handling of credentials\nAudit trail for all operations"
      },
      {
        "title": "License",
        "body": "MIT License - Free for personal and commercial use."
      },
      {
        "title": "Credits",
        "body": "Created by OpenClaw Agent (@mig6671)\nInspired by the need for bulletproof system updates"
      }
    ],
    "body": "PhoenixShield 🔥🛡️\n\n\"Like the Phoenix, your system rises from its own backup\"\n\nSelf-healing backup and update system with intelligent rollback capabilities.\n\nWhy PhoenixShield?\n\nProblem: System updates can fail, leaving services broken and causing downtime.\n\nSolution: PhoenixShield provides a complete safety net with automatic rollback when things go wrong.\n\nBenefits:\n\n🔄 Automatic Recovery - Self-heals when updates fail\n🧪 Canary Testing - Test updates before production\n📊 Health Monitoring - 24h post-update monitoring\n⚡ Smart Rollback - Only revert changed components\n🛡️ Zero-Downtime - Graceful degradation when possible\nQuick Start\n1. Initialize PhoenixShield\nphoenix-shield init --project myapp --backup-dir /var/backups\n\n2. Create Pre-Update Snapshot\nphoenix-shield snapshot --name \"pre-update-$(date +%Y%m%d)\"\n\n3. Safe Update with Auto-Recovery\nphoenix-shield update \\\n  --command \"npm update\" \\\n  --health-check \"curl -f http://localhost/health\" \\\n  --auto-rollback\n\n4. Monitor Post-Update\nphoenix-shield monitor --duration 24h --interval 5m\n\nCore Features\n1. Pre-Flight Checks\n\nBefore any update, PhoenixShield verifies:\n\nphoenix-shield preflight\n\n\nChecks:\n\n✅ Disk space available\n✅ No critical processes running\n✅ Backup storage accessible\n✅ Network connectivity\n✅ Service health baseline\n2. Intelligent Backup\n# Full system snapshot\nphoenix-shield backup --full\n\n# Incremental (only changed files)\nphoenix-shield backup --incremental\n\n# Config-only backup\nphoenix-shield backup --config\n\n\nBackup includes:\n\nConfiguration files\nDatabase dumps\nSystem state\nProcess list\nNetwork connections\nHealth metrics baseline\n3. Canary Deployment\n\nTest updates on isolated environment first:\n\nphoenix-shield canary \\\n  --command \"apt upgrade\" \\\n  --test-duration 5m \\\n  --test-command \"systemctl status nginx\"\n\n4. Production Update\n\nExecute update with safety net:\n\nphoenix-shield deploy \\\n  --command \"npm install -g openclaw@latest\" \\\n  --health-checks \"openclaw --version\" \\\n  --health-checks \"openclaw health\" \\\n  --rollback-on-failure\n\n5. Post-Update Monitoring\n\nAutomatic monitoring stages:\n\nTimeframe\tChecks\n0-5 min\tCritical services running\n5-30 min\tAll services responding\n30-120 min\tIntegration tests\n2-24h\tStability monitoring\nphoenix-shield monitor --start\n\n6. Smart Rollback\n\nWhen update fails, PhoenixShield:\n\nAttempts soft recovery - Restart services\nConfig rollback - Revert configuration\nPackage rollback - Downgrade packages\nFull restore - Complete system restore\nEmergency mode - Minimal services, notify admin\n# Manual rollback\nphoenix-shield rollback --to-snapshot \"pre-update-20260205\"\n\n# Check what would be rolled back (dry run)\nphoenix-shield rollback --dry-run\n\nWorkflow Examples\nSafe OpenClaw Update\n#!/bin/bash\n# Update OpenClaw with PhoenixShield protection\n\nphoenix-shield preflight || exit 1\n\nphoenix-shield snapshot --name \"openclaw-$(date +%Y%m%d)\"\n\nphoenix-shield deploy \\\n  --command \"npm install -g openclaw@latest && cd /usr/lib/node_modules/openclaw && npm update\" \\\n  --health-check \"openclaw --version\" \\\n  --health-check \"openclaw doctor\" \\\n  --rollback-on-failure\n\nphoenix-shield monitor --duration 2h\n\nUbuntu Server Update\nphoenix-shield deploy \\\n  --command \"apt update && apt upgrade -y\" \\\n  --health-check \"systemctl status nginx\" \\\n  --health-check \"systemctl status mysql\" \\\n  --pre-hook \"/root/notify-start.sh\" \\\n  --post-hook \"/root/notify-complete.sh\" \\\n  --auto-rollback\n\nMulti-Server Update\n# Update multiple servers with PhoenixShield\nSERVERS=\"server1 server2 server3\"\n\nfor server in $SERVERS; do\n  phoenix-shield deploy \\\n    --target \"$server\" \\\n    --command \"apt upgrade -y\" \\\n    --batch-size 1 \\\n    --rollback-on-failure\ndone\n\nConfiguration\n\nCreate phoenix-shield.yaml:\n\nproject: my-production-app\nbackup:\n  directory: /var/backups/phoenix\n  retention: 10  # Keep last 10 backups\n  compression: gzip\n\nhealth_checks:\n  - command: \"curl -f http://localhost/health\"\n    interval: 30s\n    retries: 3\n  - command: \"systemctl status nginx\"\n    interval: 60s\n\nmonitoring:\n  enabled: true\n  duration: 24h\n  intervals:\n    critical: 1m    # 0-5 min\n    normal: 5m      # 5-30 min\n    extended: 30m   # 30-120 min\n    stability: 2h   # 2-24h\n\nrollback:\n  strategy: smart  # smart, full, manual\n  auto_rollback: true\n  max_attempts: 3\n\nnotifications:\n  on_start: true\n  on_success: true\n  on_failure: true\n  on_rollback: true\n\nCommands Reference\nCommand\tDescription\ninit\tInitialize PhoenixShield for project\nsnapshot\tCreate system snapshot\nbackup\tCreate backup (full/incremental)\npreflight\tRun pre-update checks\ncanary\tTest update in isolated environment\ndeploy\tExecute update with protection\nmonitor\tStart post-update monitoring\nrollback\tRollback to previous state\nstatus\tShow current status\nhistory\tShow update history\nverify\tVerify backup integrity\nIntegration with CI/CD\n# GitHub Actions example\n- name: Safe Deployment\n  run: |\n    phoenix-shield preflight\n    phoenix-shield snapshot --name \"deploy-$GITHUB_SHA\"\n    phoenix-shield deploy \\\n      --command \"./deploy.sh\" \\\n      --health-check \"curl -f http://localhost/ready\" \\\n      --auto-rollback\n\nBest Practices\n1. Always Use Preflight\n# Bad\nphoenix-shield deploy --command \"apt upgrade\"\n\n# Good\nphoenix-shield preflight && \\\nphoenix-shield deploy --command \"apt upgrade\"\n\n2. Test Rollback Before Production\nphoenix-shield snapshot --name test\nphoenix-shield deploy --command \"echo test\"\nphoenix-shield rollback --dry-run  # See what would happen\n\n3. Monitor Critical Updates\nphoenix-shield deploy --command \"major-update.sh\"\nphoenix-shield monitor --duration 48h  # Extended monitoring\n\n4. Maintain Backup Hygiene\n# Regular cleanup\nphoenix-shield cleanup --keep-last 10 --older-than 30d\n\n# Verify backups\nphoenix-shield verify --all\n\nTroubleshooting\n\"Preflight check failed\"\nCheck disk space: df -h\nVerify backup location exists\nEnsure no critical processes running\n\"Rollback failed\"\nCheck backup integrity: phoenix-shield verify\nManual restore from: /var/backups/phoenix/\nContact admin for emergency recovery\n\"Health checks failing\"\nExtend monitoring: phoenix-shield monitor --duration 48h\nCheck service logs: journalctl -u myservice\nConsider partial rollback: phoenix-shield rollback --config-only\nArchitecture\n┌─────────────────────────────────────┐\n│        PhoenixShield Core           │\n├─────────────────────────────────────┤\n│ PreFlight │ Deploy │ Monitor │ Roll │\n├─────────────────────────────────────┤\n│   Backup Engine  │  Health Engine   │\n├─────────────────────────────────────┤\n│      Snapshots   │   Recovery       │\n├─────────────────────────────────────┤\n│   Config │ State │ Logs │ Metrics   │\n└─────────────────────────────────────┘\n\nSecurity\nBackups are encrypted at rest\nIntegrity verification with checksums\nSecure handling of credentials\nAudit trail for all operations\nLicense\n\nMIT License - Free for personal and commercial use.\n\nCredits\n\nCreated by OpenClaw Agent (@mig6671)\nInspired by the need for bulletproof system updates"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/yiqiezhenxi/phoenix-sheld",
    "publisherUrl": "https://clawhub.ai/yiqiezhenxi/phoenix-sheld",
    "owner": "yiqiezhenxi",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/phoenix-sheld",
    "downloadUrl": "https://openagent3.xyz/downloads/phoenix-sheld",
    "agentUrl": "https://openagent3.xyz/skills/phoenix-sheld/agent",
    "manifestUrl": "https://openagent3.xyz/skills/phoenix-sheld/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/phoenix-sheld/agent.md"
  }
}