# Send Phoenix Shield to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/phoenix-sheld",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phoenix-sheld",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "phoenix-sheld",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T01:51:26.955Z",
      "expiresAt": "2026-05-14T01:51:26.955Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phoenix-sheld",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=phoenix-sheld",
        "contentDisposition": "attachment; filename=\"phoenix-sheld-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "phoenix-sheld"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### PhoenixShield 🔥🛡️

"Like the Phoenix, your system rises from its own backup"

Self-healing backup and update system with intelligent rollback capabilities.

### Why PhoenixShield?

Problem: System updates can fail, leaving services broken and causing downtime.

Solution: PhoenixShield provides a complete safety net with automatic rollback when things go wrong.

Benefits:

🔄 Automatic Recovery - Self-heals when updates fail
🧪 Canary Testing - Test updates before production
📊 Health Monitoring - 24h post-update monitoring
⚡ Smart Rollback - Only revert changed components
🛡️ Zero-Downtime - Graceful degradation when possible

### 1. Initialize PhoenixShield

phoenix-shield init --project myapp --backup-dir /var/backups

### 2. Create Pre-Update Snapshot

phoenix-shield snapshot --name "pre-update-$(date +%Y%m%d)"

### 3. Safe Update with Auto-Recovery

phoenix-shield update \\
  --command "npm update" \\
  --health-check "curl -f http://localhost/health" \\
  --auto-rollback

### 4. Monitor Post-Update

phoenix-shield monitor --duration 24h --interval 5m

### 1. Pre-Flight Checks

Before any update, PhoenixShield verifies:

phoenix-shield preflight

Checks:

✅ Disk space available
✅ No critical processes running
✅ Backup storage accessible
✅ Network connectivity
✅ Service health baseline

### 2. Intelligent Backup

# Full system snapshot
phoenix-shield backup --full

# Incremental (only changed files)
phoenix-shield backup --incremental

# Config-only backup
phoenix-shield backup --config

Backup includes:

Configuration files
Database dumps
System state
Process list
Network connections
Health metrics baseline

### 3. Canary Deployment

Test updates on isolated environment first:

phoenix-shield canary \\
  --command "apt upgrade" \\
  --test-duration 5m \\
  --test-command "systemctl status nginx"

### 4. Production Update

Execute update with safety net:

phoenix-shield deploy \\
  --command "npm install -g openclaw@latest" \\
  --health-checks "openclaw --version" \\
  --health-checks "openclaw health" \\
  --rollback-on-failure

### 5. Post-Update Monitoring

Automatic monitoring stages:

TimeframeChecks0-5 minCritical services running5-30 minAll services responding30-120 minIntegration tests2-24hStability monitoring

phoenix-shield monitor --start

### 6. Smart Rollback

When update fails, PhoenixShield:

Attempts soft recovery - Restart services
Config rollback - Revert configuration
Package rollback - Downgrade packages
Full restore - Complete system restore
Emergency mode - Minimal services, notify admin

# Manual rollback
phoenix-shield rollback --to-snapshot "pre-update-20260205"

# Check what would be rolled back (dry run)
phoenix-shield rollback --dry-run

### Safe OpenClaw Update

#!/bin/bash
# Update OpenClaw with PhoenixShield protection

phoenix-shield preflight || exit 1

phoenix-shield snapshot --name "openclaw-$(date +%Y%m%d)"

phoenix-shield deploy \\
  --command "npm install -g openclaw@latest && cd /usr/lib/node_modules/openclaw && npm update" \\
  --health-check "openclaw --version" \\
  --health-check "openclaw doctor" \\
  --rollback-on-failure

phoenix-shield monitor --duration 2h

### Ubuntu Server Update

phoenix-shield deploy \\
  --command "apt update && apt upgrade -y" \\
  --health-check "systemctl status nginx" \\
  --health-check "systemctl status mysql" \\
  --pre-hook "/root/notify-start.sh" \\
  --post-hook "/root/notify-complete.sh" \\
  --auto-rollback

### Multi-Server Update

# Update multiple servers with PhoenixShield
SERVERS="server1 server2 server3"

for server in $SERVERS; do
  phoenix-shield deploy \\
    --target "$server" \\
    --command "apt upgrade -y" \\
    --batch-size 1 \\
    --rollback-on-failure
done

### Configuration

Create phoenix-shield.yaml:

project: my-production-app
backup:
  directory: /var/backups/phoenix
  retention: 10  # Keep last 10 backups
  compression: gzip

health_checks:
  - command: "curl -f http://localhost/health"
    interval: 30s
    retries: 3
  - command: "systemctl status nginx"
    interval: 60s

monitoring:
  enabled: true
  duration: 24h
  intervals:
    critical: 1m    # 0-5 min
    normal: 5m      # 5-30 min
    extended: 30m   # 30-120 min
    stability: 2h   # 2-24h

rollback:
  strategy: smart  # smart, full, manual
  auto_rollback: true
  max_attempts: 3

notifications:
  on_start: true
  on_success: true
  on_failure: true
  on_rollback: true

### Commands Reference

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

### Integration with CI/CD

# GitHub Actions example
- name: Safe Deployment
  run: |
    phoenix-shield preflight
    phoenix-shield snapshot --name "deploy-$GITHUB_SHA"
    phoenix-shield deploy \\
      --command "./deploy.sh" \\
      --health-check "curl -f http://localhost/ready" \\
      --auto-rollback

### 1. Always Use Preflight

# Bad
phoenix-shield deploy --command "apt upgrade"

# Good
phoenix-shield preflight && \\
phoenix-shield deploy --command "apt upgrade"

### 2. Test Rollback Before Production

phoenix-shield snapshot --name test
phoenix-shield deploy --command "echo test"
phoenix-shield rollback --dry-run  # See what would happen

### 3. Monitor Critical Updates

phoenix-shield deploy --command "major-update.sh"
phoenix-shield monitor --duration 48h  # Extended monitoring

### 4. Maintain Backup Hygiene

# Regular cleanup
phoenix-shield cleanup --keep-last 10 --older-than 30d

# Verify backups
phoenix-shield verify --all

### "Preflight check failed"

Check disk space: df -h
Verify backup location exists
Ensure no critical processes running

### "Rollback failed"

Check backup integrity: phoenix-shield verify
Manual restore from: /var/backups/phoenix/
Contact admin for emergency recovery

### "Health checks failing"

Extend monitoring: phoenix-shield monitor --duration 48h
Check service logs: journalctl -u myservice
Consider partial rollback: phoenix-shield rollback --config-only

### Architecture

┌─────────────────────────────────────┐
│        PhoenixShield Core           │
├─────────────────────────────────────┤
│ PreFlight │ Deploy │ Monitor │ Roll │
├─────────────────────────────────────┤
│   Backup Engine  │  Health Engine   │
├─────────────────────────────────────┤
│      Snapshots   │   Recovery       │
├─────────────────────────────────────┤
│   Config │ State │ Logs │ Metrics   │
└─────────────────────────────────────┘

### Security

Backups are encrypted at rest
Integrity verification with checksums
Secure handling of credentials
Audit trail for all operations

### License

MIT License - Free for personal and commercial use.

### Credits

Created by OpenClaw Agent (@mig6671)
Inspired by the need for bulletproof system updates
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: yiqiezhenxi
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T01:51:26.955Z
- Expires at: 2026-05-14T01:51:26.955Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/phoenix-sheld)
- [Send to Agent page](https://openagent3.xyz/skills/phoenix-sheld/agent)
- [JSON manifest](https://openagent3.xyz/skills/phoenix-sheld/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/phoenix-sheld/agent.md)
- [Download page](https://openagent3.xyz/downloads/phoenix-sheld)