Déploiement d’agent AI étape par étape

Déployer un agent IA étape par étape — du développement local à un service de production en fonctionnement. Pas d’abstractions, pas de « cela dépend », juste les commandes et décisions réelles.

Étape 1 : Obtenir un serveur

Vous avez besoin d’un serveur Linux avec au moins 2 Go de RAM (4 Go recommandé), une adresse IP publique et un accès SSH. Un VPS à 10-20 $/mois d’un fournisseur majeur fonctionne bien. J’utilise Ubuntu 22.04 LTS car il est stable et bien documenté.

Après la provision : mettez à jour le système (apt update && apt upgrade), créez un utilisateur non root, configurez l’authentification par clé SSH et désactivez la connexion par mot de passe. Cela prend 10 minutes et c’est le minimum pour la sécurité.

Étape 2 : Installer les dépendances

Node.js (version LTS), npm et Git. C’est le minimum pour OpenClaw. Si vous utilisez une base de données, installez-la aussi. Si vous utilisez Docker, installez Docker.

J’installe Node via nvm (Node Version Manager) car cela facilite la gestion des versions. Lorsque OpenClaw nécessite une nouvelle version de Node, nvm install et nvm use s’en occupent sans affecter quoi que ce soit d’autre sur le serveur.

Étape 3 : Cloner et configurer

Clonez votre dépôt (ou installez OpenClaw depuis npm). Créez le fichier de configuration avec vos clés API, préférences de modèle et paramètres d’intégration.

Le fichier de configuration est l’élément le plus important de votre déploiement. Tout ce que l’agent fait en dépend. Je garde un modèle de config dans le dépôt avec des valeurs de substitution et un fichier .env séparé (pas dans le dépôt) avec les véritables secrets.

Étape 4 : Tester localement sur le serveur

Avant de configurer la gestion des processus ou des proxies inverses, exécutez l’agent manuellement : node index.js (ou quel que soit le commandement de démarrage). Envoyez-lui un message de test. Vérifiez qu’il répond correctement. Cela permet de saisir les problèmes spécifiques à l’environnement (dépendances manquantes, chemins incorrects, APIs inaccessibles) avant d’ajouter des couches de complexité.

S’il ne fonctionne pas manuellement, il ne fonctionnera pas derrière PM2 ou Docker non plus. Déboguez ici, pas plus tard.

Étape 5 : Gestion des processus

Installez PM2 (npm install -g pm2) et configurez l’agent en tant que processus géré : pm2 start ecosystem.config.js.

PM2 vous offre : redémarrage automatique en cas de crash, gestion des journaux avec rotation, génération de script de démarrage (pour que l’agent démarre au démarrage), et commandes de surveillance pour vérifier l’état.

Exécutez pm2 startup pour générer le script de démarrage du système. Exécutez pm2 save pour enregistrer la liste actuelle des processus. Maintenant, l’agent survit aux redémarrages.

Étape 6 : Proxy inversé (si nécessaire)

Si l’agent doit recevoir des webhooks de services externes, configurez un proxy inversé (Caddy ou nginx) qui gère la terminaison SSL et achemine le trafic vers l’agent.

Caddy est plus simple : un Caddyfile de 4 lignes vous permet d’obtenir HTTPS avec renouvellement automatique de certificat. Nginx est plus configurable mais nécessite une gestion manuelle des certificats (utilisez Certbot).

Si l’agent effectue uniquement des connexions sortantes (plateformes de messagerie, appels API) et ne reçoit pas de trafic entrant, passez cette étape.

Étape 7 : Surveillance

Au minimum : configurez la surveillance des journaux et un contrôle de santé de base.

Journaux : PM2 gère la rotation des journaux. Configurez un moyen de visualiser les journaux à distance (j’utilise pm2 logs via SSH ou un simple visualiseur de journaux).

Contrôle de santé : Un cron job qui vérifie si le processus est en cours d’exécution et vous alerte s’il ne l’est pas. Cinq lignes de script bash. Programmez-le pour s’exécuter toutes les 5 minutes.

Pour une surveillance plus sophistiquée (métriques, tableaux de bord, alertes), consultez mon article sur Grafana. Mais le contrôle de santé de base couvre 90% de ce dont vous avez besoin.

Étape 8 : Sauvegarde

Configurez des sauvegardes quotidiennes de vos fichiers de configuration et de données. Consultez mon article sur la stratégie de sauvegarde pour l’approche complète. Au minimum : copiez votre configuration et vos données vers un deuxième emplacement chaque jour.

Étape 9 : Documentation

Notez : l’IP du serveur, comment se connecter en SSH, où se trouve la configuration, comment redémarrer le service, comment consulter les journaux et comment effectuer une restauration. Votre futur vous remerciera.

Le processus complet prend environ 2 heures

Étapes 1-4 : 45 minutes. Étapes 5-6 : 30 minutes. Étapes 7-9 : 45 minutes.

Après ces 2 heures, vous avez un agent IA prêt pour la production, fonctionnant sur un serveur fiable avec gestion des processus, surveillance, sauvegardes et documentation. Pas sur-ingénéré. Pas sous-ingénéré. Juste ce qu’il faut pour un point de départ que vous pouvez améliorer progressivement.

🕒 Published: March 26, 2026