Blog/Tutorial

Cómo automatizar snapshots de tu VPS con OpenClaw — Ejemplo con API de Hostinger

TUTORIAL2026-02-269 min lectura
Racks de servidores en un centro de datos con iluminación azul

Todo administrador de sistemas conoce la sensación: estás a punto de aplicar una actualización arriesgada en tu VPS y piensas "debería hacer un snapshot primero" — y luego te olvidas. Con el programador de cron integrado en OpenClaw y la API REST de tu proveedor de hosting, puedes hacer que tu agente de IA tome un snapshot automáticamente según un calendario, o cuando se lo pidas por chat. Esta guía muestra la configuración usando Hostinger VPS, con ejemplos equivalentes para DigitalOcean, Hetzner y Vultr.

INFO

Este tutorial funciona con cualquier proveedor de VPS que exponga una API REST para snapshots. El patrón es idéntico — solo cambian la URL del endpoint y el token de autenticación.

Qué vas a construir

  • Un agente OpenClaw que puede tomar un snapshot del VPS bajo demanda cuando le escribes
  • Un cron job programado que hace el snapshot automáticamente (ej: cada semana)
  • Un mensaje de confirmación enviado a tu Telegram o Slack cuando el snapshot se completa
  • Una comprobación de seguridad que te avisa si ya existe un snapshot antes de sobrescribirlo

Paso 1 — Obtener tu token de la API de Hostinger

Hostinger usa autenticación Bearer token para todas las llamadas a la API. Para generar el tuyo:

  1. Entra en hpanel.hostinger.com
  2. Ve a Configuración de Cuenta → API
  3. Haz clic en Generar nuevo token y ponle un nombre como "OpenClaw Snapshots"
  4. Copia el token inmediatamente — solo se muestra una vez
  5. Anota el ID numérico de tu VPS desde la URL del panel o vía la API
WARNING

Hostinger solo permite UN snapshot por VPS a la vez. Crear un nuevo snapshot sobrescribe el existente. Tu agente debe advertirte sobre esto antes de proceder.

Paso 2 — Entender la API de snapshots de Hostinger

La API VPS de Hostinger expone cuatro endpoints sencillos para la gestión de snapshots. Todas las llamadas usan autenticación Bearer token:

bash
# Obtener snapshot actual (comprobar si existe uno)
GET https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer TU_API_TOKEN

# Crear un nuevo snapshot (¡sobrescribe el existente!)
POST https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer TU_API_TOKEN

# Restaurar desde el snapshot actual
POST https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot/restore
Authorization: Bearer TU_API_TOKEN

# Eliminar el snapshot actual
DELETE https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer TU_API_TOKEN

Todas las peticiones son asíncronas — la API devuelve un objeto de acción inmediatamente y el snapshot se crea en segundo plano. Tu agente puede confirmar que la acción fue encolada.

Paso 3 — Configurar tu agente OpenClaw

Dale a tu agente OpenClaw un prompt de sistema que explique cómo interactuar con tu VPS. Guarda tus credenciales como variables de entorno y referenciarlas en el prompt:

text
Eres un asistente de gestión de servidores para [Tu Nombre].

Detalles de tu VPS:
- Proveedor: Hostinger
- VM ID: 123456
- API Base: https://api.hostinger.com/api/vps/v1/virtual-machines/123456
- Auth: Bearer token en variable de entorno HOSTINGER_API_TOKEN

Puedes realizar las siguientes acciones cuando se te pida:
1. HACER SNAPSHOT: POST .../snapshot
   - SIEMPRE comprueba primero si existe un snapshot (GET .../snapshot)
   - AVISA al usuario que crear un snapshot sobrescribirá el existente
   - Solo procede tras confirmación del usuario

2. COMPROBAR SNAPSHOT: GET .../snapshot
   - Informa de la fecha, tamaño y estado del snapshot

3. RESTAURAR SNAPSHOT: POST .../snapshot/restore
   - Es DESTRUCTIVO — pide siempre confirmación explícita
   - Avisa que el VPS volverá al estado del snapshot y se perderán cambios recientes

4. ELIMINAR SNAPSHOT: DELETE .../snapshot
   - Confirma antes de eliminar

Paso 4 — Probar snapshots bajo demanda por chat

Con el agente configurado, ya puedes activar snapshots simplemente escribiendo a tu bot. El agente gestiona la llamada a la API, comprueba si existe un snapshot previo y confirma el resultado:

javascript
// Esto es lo que ejecuta internamente tu agente OpenClaw
// cuando le envías: "Haz un snapshot de mi VPS"

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

// Paso 1: Comprobar si ya existe un snapshot
const check = await fetch(`${base}/snapshot`, {
  headers: { Authorization: `Bearer ${token}` }
});
const existing = await check.json();

if (existing?.created_at) {
  return `⚠️ Existe un snapshot del ${existing.created_at}.
Continuar lo SOBRESCRIBIRÁ. Responde 'confirmar' para seguir.`;
}

// Paso 2: Crear el snapshot tras confirmación
const snap = await fetch(`${base}/snapshot`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` }
});
const action = await snap.json();

return `✅ Snapshot encolado (ID de acción: ${action.id}).
Se está capturando el estado de tu VPS — tarda 1-3 minutos.`;

Paso 5 — Programar un cron semanal por chat

OpenClaw tiene un programador de cron integrado que se configura completamente por conversación — sin necesidad de terminal ni acceso al servidor. Simplemente dile a tu bot qué calendario quieres y él configura el job recurrente automáticamente:

text
Tú → Configura un cron semanal para hacer un snapshot de mi VPS
       cada domingo a las 3:00 AM. Mándame el resultado aquí por
       Telegram cuando se ejecute. No pidas confirmación al ejecutarse
       de forma automática.

Bot → ✅ ¡Hecho! He programado un snapshot semanal:
       • Horario: Todos los domingos a las 03:00 UTC
       • Acción: Crear snapshot (sin confirmación, automático)
       • Notificación: Te aviso aquí después de cada ejecución

       Di "muéstrame mis crons" o "cancela el cron de snapshots"
       para gestionarlo en cualquier momento.
TIP

Dile a tu bot exactamente lo que quieres en lenguaje natural: el horario ("cada domingo por la noche", "cada lunes a las 2am"), qué hacer (snapshot sin confirmación para ejecuciones automáticas) y cómo notificarte (mensaje en Telegram con el resultado).

También puedes pedir a tu bot que liste, pause o elimine cron jobs en cualquier momento simplemente chateando con él. OpenClaw mantiene todos los jobs programados en su estado interno, que persiste entre reinicios.

Paso 6 — Recibir notificaciones cuando el snapshot se completa

El flag --announce envía la respuesta del agente a tu canal configurado. Tu Telegram o Slack recibirá un mensaje así tras cada snapshot exitoso:

text
🤖 Snapshot VPS Semanal — Completado
━━━━━━━━━━━━━━━━━━━━━━━
✅ Snapshot creado correctamente
📅 Fecha: 26/02/2026 03:02:14 UTC
💾 VM: prod-server-01 (ID: 123456)
⏱ ID de acción: act_8f3k2m9x

Próximo snapshot: domingo 3 de marzo a las 03:00 UTC

Funciona con cualquier proveedor de VPS

El mismo patrón de OpenClaw funciona con cualquier proveedor de hosting que exponga una API REST. Solo cambia el endpoint y el token. Aquí está el equivalente para los proveedores más populares:

ProveedorEndpoint para crear snapshotAutenticación
HostingerPOST /api/vps/v1/virtual-machines/{id}/snapshotBearer token
DigitalOceanPOST /v2/droplets/{id}/actions (type: snapshot)Bearer token
HetznerPOST /v1/servers/{id}/actions/create_imageBearer token
VultrPOST /v2/snapshotsBearer token
Linode/AkamaiPOST /v4/linode/instances/{id}/backupsBearer token
bash
# Equivalente en DigitalOcean
curl -X POST \
  -H "Authorization: Bearer $DO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"snapshot","name":"snapshot-auto-semanal"}' \
  "https://api.digitalocean.com/v2/droplets/{droplet_id}/actions"

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

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

Casos de uso prácticos

  • "Haz un snapshot de mi servidor" antes de cada despliegue — le preguntas al bot y lo hace
  • Snapshot automático semanal cada domingo por la noche con confirmación por Telegram
  • "Restaura mi servidor" para recuperación ante desastres con un solo mensaje
  • "¿Cuándo fue el último snapshot?" — comprueba si tu backup es reciente antes de hacer cambios
  • Alertar si pasa una semana sin snapshot exitoso (monitorización con cron + mensaje condicional)

El mejor backup es el que realmente se hace. Un agente de IA que toma el snapshot cuando se lo pides — y automáticamente según un calendario — significa que nunca más lo olvidarás.

ClawDock Engineering

Despliega tu agente de gestión de servidores

Ten un bot OpenClaw funcionando en 2 minutos. Conéctalo a la API de tu VPS y gestiona tu infraestructura desde Telegram.

Desplegar Gratis
automatizar snapshots vpsopenclaw cron jobshostinger api snapshotsbackup servidor automatico iaopenclaw gestión servidorautomatizar backup vps

Despliega Tu Bot OpenClaw en Minutos

Sin servidores. Sin archivos de config. Solo tu bot, en vivo.