Blog/Tutoriel

Automatiser les snapshots VPS avec OpenClaw — Exemple API Hostinger

TUTORIEL2026-02-269 min lecture
Baies de serveurs dans un centre de données avec éclairage bleu

Tout administrateur système connaît ce sentiment : vous êtes sur le point d’appliquer une mise à jour risquée sur votre VPS et vous pensez « je devrais faire un snapshot d’abord » — puis vous oubliez. Avec le planificateur cron intégré d’OpenClaw et l’API REST de votre hébergeur, vous pouvez faire prendre un snapshot à votre agent IA automatiquement selon un planning, ou chaque fois que vous le lui demandez par chat. Ce guide détaille la configuration avec Hostinger VPS, avec des exemples équivalents pour DigitalOcean, Hetzner et Vultr.

INFO

Ce tutoriel fonctionne avec n’importe quel fournisseur VPS exposant une API REST pour les snapshots. Le schéma est identique — seuls l’URL de l’endpoint et le token d’authentification changent.

Ce que vous allez construire

  • Un agent OpenClaw capable de prendre un snapshot VPS à la demande quand vous lui écrivez
  • Un cron job planifié qui fait le snapshot automatiquement (ex : chaque semaine)
  • Un message de confirmation envoyé sur votre Telegram ou Slack quand le snapshot est terminé
  • Une vérification de sécurité qui vous avertit si un snapshot existe déjà avant de l’écraser

Étape 1 — Obtenir votre token API Hostinger

Hostinger utilise l’authentification Bearer token pour tous les appels API. Pour générer le vôtre :

  1. Connectez-vous à hpanel.hostinger.com
  2. Allez dans Paramètres du compte → API
  3. Cliquez sur Générer un nouveau token et nommez-le "OpenClaw Snapshots"
  4. Copiez le token immédiatement — il n’est affiché qu’une seule fois
  5. Notez l’ID numérique de votre VPS depuis l’URL du tableau de bord ou via l’API
WARNING

Hostinger n’autorise qu’UN seul snapshot par VPS à la fois. La création d’un nouveau snapshot écrase l’existant. Votre agent doit vous avertir avant de procéder.

Étape 2 — Comprendre l’API snapshots de Hostinger

L’API VPS Hostinger expose quatre endpoints simples pour la gestion des snapshots. Tous les appels utilisent l’authentification Bearer token :

bash
# Obtenir le snapshot actuel (vérifier s'il en existe un)
GET https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer VOTRE_API_TOKEN

# Créer un nouveau snapshot (écrase l'existant !)
POST https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer VOTRE_API_TOKEN

# Restaurer depuis le snapshot actuel
POST https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot/restore
Authorization: Bearer VOTRE_API_TOKEN

# Supprimer le snapshot actuel
DELETE https://api.hostinger.com/api/vps/v1/virtual-machines/{vmId}/snapshot
Authorization: Bearer VOTRE_API_TOKEN

Étape 3 — Configurer votre agent OpenClaw

text
Tu es un assistant de gestion de serveurs pour [Votre Nom].

Détails de votre VPS :
- Fournisseur : Hostinger
- VM ID : 123456
- API Base : https://api.hostinger.com/api/vps/v1/virtual-machines/123456
- Auth : Bearer token dans la variable d'environnement HOSTINGER_API_TOKEN

Tu peux effectuer les actions suivantes quand on te le demande :
1. PRENDRE UN SNAPSHOT : POST .../snapshot
   - TOUJOURS vérifier si un snapshot existe d'abord (GET .../snapshot)
   - AVERTIR l'utilisateur que créer un snapshot écrasera l'existant
   - Ne procéder qu'après confirmation de l'utilisateur

2. VÉRIFIER LE SNAPSHOT : GET .../snapshot
   - Signaler la date, la taille et l'état du snapshot

3. RESTAURER LE SNAPSHOT : POST .../snapshot/restore
   - C'est DESTRUCTIF — toujours demander une confirmation explicite
   - Avertir que le VPS reviendra à l'état du snapshot et que les changements récents seront perdus

4. SUPPRIMER LE SNAPSHOT : DELETE .../snapshot
   - Confirmer avant de supprimer

Étape 4 — Tester les snapshots à la demande par chat

javascript
// Ce que votre agent OpenClaw exécute en interne
// quand vous envoyez : "Prends un snapshot de mon VPS"

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

// Étape 1 : Vérifier si un snapshot existe déjà
const check = await fetch(`${base}/snapshot`, {
  headers: { Authorization: `Bearer ${token}` }
});
const existing = await check.json();

if (existing?.created_at) {
  return `⚠️ Un snapshot du ${existing.created_at} existe déjà.
Continuer l'ÉCRASERA. Répondez 'confirmer' pour continuer.`;
}

// Étape 2 : Créer le snapshot après confirmation
const snap = await fetch(`${base}/snapshot`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${token}` }
});
const action = await snap.json();

return `✅ Snapshot en attente (ID action : ${action.id}).
L'état de votre VPS est en cours de capture — cela prend 1–3 minutes.`;

Étape 5 — Planifier un cron hebdomadaire par chat

OpenClaw possède un planificateur cron intégré que vous configurez entièrement par conversation — sans terminal ni accès serveur. Dites simplement à votre bot le planning souhaité et il configure le job récurrent automatiquement :

text
Vous → Configure un cron hebdomadaire pour prendre un snapshot de mon
        VPS chaque dimanche à 3h00 du matin. Envoie-moi le résultat
        ici sur Telegram quand c'est exécuté. Ne demande pas de
        confirmation lors des exécutions automatiques.

Bot  → ✅ C'est fait ! J'ai planifié un snapshot VPS hebdomadaire :
        • Planning : Tous les dimanches à 03:00 UTC
        • Action : Créer snapshot (auto-confirm, sans invite)
        • Notification : Je vous envoie un message ici après chaque exécution

        Dites "montre mes crons" ou "annule le cron snapshot"
        pour le gérer à tout moment.
TIP

Dites à votre bot exactement ce que vous voulez en langage naturel : le planning (« chaque dimanche soir », « chaque lundi à 2h »), l’action (snapshot sans confirmation pour les exécutions automatiques) et comment vous notifier (message Telegram avec le résultat).

Vous pouvez aussi demander à votre bot de lister, mettre en pause ou supprimer des cron jobs à tout moment, simplement en discutant avec lui. OpenClaw conserve tous les jobs planifiés dans son état interne, qui persiste entre les redémarrages.

Étape 6 — Recevoir des notifications quand le snapshot est terminé

text
🤖 Snapshot VPS Hebdomadaire — Terminé
━━━━━━━━━━━━━━━━━━━━━━━
✅ Snapshot créé avec succès
📅 Date : 26/02/2026 03:02:14 UTC
💾 VM : prod-server-01 (ID : 123456)
⏱ ID action : act_8f3k2m9x

Prochain snapshot : dimanche 3 mars à 03:00 UTC

Fonctionne avec n’importe quel fournisseur VPS

Le même schéma OpenClaw fonctionne avec n’importe quel fournisseur d’hébergement exposant une API REST. Il suffit de changer l’endpoint et le token. Voici l’équivalent pour les fournisseurs les plus populaires :

FournisseurEndpoint création snapshotAuthentification
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

Cas d’utilisation pratiques

  • « Fais un snapshot de mon serveur » avant chaque déploiement — demandez au bot, il confirme et exécute
  • Snapshot automatique hebdomadaire chaque dimanche soir avec confirmation Telegram
  • « Restaure mon serveur » pour une récupération après sinistre en un seul message
  • « Quand date mon dernier snapshot ? » — vérifiez si votre sauvegarde est récente avant de faire des changements
  • Vous alerter si une semaine passe sans snapshot réussi (surveillance avec cron + message conditionnel)

La meilleure sauvegarde est celle qui se fait vraiment. Un agent IA qui prend votre snapshot quand vous le demandez — et automatiquement selon un planning — signifie que vous n’oublierez plus jamais.

ClawDock Engineering

Déployez votre agent de gestion de serveurs

Ayez un bot OpenClaw opérationnel en 2 minutes. Connectez-le à l’API de votre VPS et gérez votre infrastructure depuis Telegram.

Déployer gratuitement
automatiser snapshots vpsopenclaw cron jobshostinger api snapshotssauvegarde serveur automatique iaopenclaw gestion serveurautomatiser backup vps

Déployez Votre Bot OpenClaw en Minutes

Sans serveurs. Sans fichiers de config. Juste votre bot, en ligne.