How to Automate VPS Snapshots with OpenClaw — Hostinger API Example

# Get current snapshot (check if one exists)
GET https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer YOUR_API_TOKEN

# Create a new snapshot (overwrites any existing one!)
POST https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer YOUR_API_TOKEN

# Restore from the current snapshot
POST https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot/restore
Authorization: Bearer YOUR_API_TOKEN

# Delete the current snapshot
DELETE https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer YOUR_API_TOKEN

You are a server management assistant for [Your Name]'s VPS infrastructure.

Your VPS details:
- Provider: Hostinger
- VM ID: 123456
- API Base: https://api.hostinger.com/api/vps/v1/virtual-machines/123456
- Auth: Bearer token stored in env var HOSTINGER_API_TOKEN

You can perform the following actions when asked:
1. TAKE SNAPSHOT: POST .../snapshot
   - ALWAYS check if a snapshot already exists first (GET .../snapshot)
   - WARN the user that creating a snapshot will overwrite the existing one
   - Only proceed after user confirms
   - Report the snapshot creation time when done

2. CHECK SNAPSHOT: GET .../snapshot
   - Report the snapshot date, size, and status

3. RESTORE SNAPSHOT: POST .../snapshot/restore
   - This is DESTRUCTIVE — always ask for explicit confirmation
   - Warn that the VPS will revert to the snapshot state and recent changes will be lost

4. DELETE SNAPSHOT: DELETE .../snapshot
   - Confirm before deleting

Always use proper Authorization headers and handle API errors gracefully.

// This is what your OpenClaw agent executes internally
// when you send: "Take a snapshot of my VPS"

const token = process.env.HOSTINGER_API_TOKEN;
const vmId = '123456';
const base = `https://api.hostinger.com/api/vps/v1/virtual-machines/${vmId}`;

// Step 1: Check if snapshot already exists
const check = await fetch(`${base}/snapshot`, {
  headers: { Authorization: `Bearer ${token}` }
});
const existing = await check.json();

if (existing?.created_at) {
  // Warn user and wait for confirmation
  return `⚠️ A snapshot from ${existing.created_at} already exists.
Proceeding will OVERWRITE it. Reply 'confirm' to continue.`;
}

// Step 2: Create snapshot after confirmation
const snap = await fetch(`${base}/snapshot`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` }
});
const action = await snap.json();

return `✅ Snapshot queued (action ID: ${action.id}).
Your VPS state is being captured — this takes 1–3 minutes.`;

You → Set up a weekly cron job to take a VPS snapshot every Sunday
       at 3:00 AM UTC. Send me the result here on Telegram when it runs.
       Don't ask for confirmation when running automatically.

Bot → ✅ Done! I've scheduled a weekly VPS snapshot job:
       • Schedule: Every Sunday at 03:00 UTC
       • Action: Create snapshot (auto-confirm, no prompt)
       • Notification: I'll message you here after each run

       You can say "show my cron jobs" or "cancel the snapshot cron"
       to manage it anytime.

🤖 Weekly VPS Snapshot — Completed
━━━━━━━━━━━━━━━━━━━━━━━
✅ Snapshot created successfully
📅 Date: 2026-02-26 03:02:14 UTC
💾 VM: prod-server-01 (ID: 123456)
⏱ Action ID: act_8f3k2m9x

Next snapshot: Sunday, March 3 at 03:00 UTC

# DigitalOcean equivalent
curl -X POST \
  -H "Authorization: Bearer $DO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"snapshot","name":"weekly-auto-snapshot"}' \
  "https://api.digitalocean.com/v2/droplets/{droplet_id}/actions"

# Hetzner equivalent
curl -X POST \
  -H "Authorization: Bearer $HETZNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description":"weekly-auto-snapshot","type":"snapshot"}' \
  "https://api.hetzner.cloud/v1/servers/{server_id}/actions/create_image"

# Vultr equivalent
curl -X POST \
  -H "Authorization: Bearer $VULTR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instance_id":"YOUR_ID","description":"weekly-auto-snapshot"}' \
  "https://api.vultr.com/v2/snapshots"