02 - Installer OpenClaw sur un VPS en 30 minutes

Introduction

Vous avez découvert ce qu'est OpenClaw et vous êtes convaincu ? Parfait. Dans ce guide pas à pas, on va installer OpenClaw sur un VPS (serveur privé virtuel) depuis zéro. En 30 minutes, vous aurez un agent IA fonctionnel, connecté à Telegram, prêt à travailler pour vous 24h/24.

Pas de blabla inutile — que du concret.

Étape 1 : Choisir son VPS

Les options recommandées

💡 Recommandation pour débuter : Hostinger VPS KVM 1 (1 vCPU, 4 Go RAM, 50 Go SSD) à ~4€/mois. Avec notre code partenaire, vous bénéficiez de 20% de remise sur un pack annuel. Interface claire, support en français, parfait pour débuter. Alternative : Hetzner CX22 pour les utilisateurs avancés.

Configuration minimale requise

• CPU : 1 vCPU (suffisant)
• RAM : 2 Go minimum (4 Go recommandé)
• Disque : 20 Go minimum
• OS : Ubuntu 22.04 ou 24.04 LTS (recommandé)
• Réseau : IPv4 publique

⚠️ Important : OpenClaw lui-même consomme peu de ressources. Le Gateway est un processus Node.js léger. La puissance de calcul IA est déportée sur les API (OpenRouter, Anthropic, etc.).

Étape 2 : Se connecter en SSH

Une fois votre VPS créé, connectez-vous :

ssh [[username]]@[[ip]]

Si vous avez configuré une clé SSH (recommandé) :

ssh -i ~/.ssh/ma_cle [[username]]@[[ip]]

Première chose à faire — mettre à jour le système :

apt update

Puis :

apt upgrade -y

Sécurisation basique (optionnel mais recommandé)

# Créer un utilisateur non-root
adduser openclaw
usermod -aG sudo openclaw

# Configurer le firewall
ufw allow 22/tcp    # SSH
ufw allow 443/tcp   # HTTPS (si vous exposez l'interface web)
ufw enable

💡 Conseil : Pour un guide complet de sécurisation, consultez notre article Sécuriser OpenClaw.

Étape 3 : Installer Node.js 22+

OpenClaw nécessite Node.js version 22 ou supérieure. Voici comment l'installer proprement :

Méthode recommandée (NodeSource)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -

Puis installez Node.js :

apt install -y nodejs

Vérifiez l'installation :

node --version

Vous devriez voir v22.x.x ou supérieur. Vérifiez aussi npm :

npm --version

Méthode alternative (nvm)

Si vous préférez gérer plusieurs versions de Node :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

⚠️ Attention : Si vous utilisez nvm, assurez-vous que le service systemd (qu'on configurera plus tard) pointe vers le bon binaire Node.

Étape 4 : Installer OpenClaw

Méthode 1 : Script d'installation (recommandée)

La méthode la plus simple — le script gère tout automatiquement :

curl -fsSL https://openclaw.ai/install.sh | bash

Ce script va :
1. Vérifier que Node.js 22+ est installé (et l'installer sinon)
2. Installer OpenClaw globalement via npm
3. Lancer l'assistant d'onboarding

Méthode 2 : Installation manuelle via npm

Si vous préférez contrôler chaque étape :

npm install -g openclaw@latest

Puis lancez l'onboarding :

openclaw onboard --install-daemon

💡 En cas d'erreur avec sharp : Si vous voyez des erreurs de compilation liées à sharp, utilisez :

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Vérifiez que tout est installé :

openclaw --version

Puis vérifiez la santé de l'installation :

openclaw doctor

La commande openclaw doctor vérifie votre installation et signale les problèmes éventuels. C'est votre meilleur ami pour le diagnostic.

Étape 5 : Configuration initiale

Lancer le setup interactif

openclaw setup

Cette commande va :
- Créer le fichier de configuration ~/.openclaw/openclaw.json
- Initialiser le workspace ~/.openclaw/workspace
- Créer les fichiers de base (SOUL.md, AGENTS.md, USER.md, etc.)

Configuration manuelle

Si vous préférez éditer directement, créez le fichier de configuration :

mkdir -p ~/.openclaw

Puis éditez le fichier de configuration :

nano ~/.openclaw/openclaw.json

Voici une configuration minimale fonctionnelle :

{
  // Workspace de l'agent
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace"
    }
  }
}

Étape 6 : Configurer le modèle IA (OpenRouter)

OpenClaw a besoin d'un modèle de langage pour fonctionner. La solution la plus flexible est OpenRouter, qui donne accès à des dizaines de modèles (Claude, GPT-4, Gemini, Llama…) via une seule API.

Créer un compte OpenRouter

1. Allez sur openrouter.ai
2. Créez un compte
3. Ajoutez des crédits (5$ suffisent pour commencer)
4. Générez une clé API dans Keys

Configurer OpenRouter dans OpenClaw

Ajoutez la clé à votre configuration :

openclaw config set models.providers.openrouter.apiKey "sk-or-v1-VOTRE_CLE_ICI"

Ou éditez directement ~/.openclaw/openclaw.json :

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      model: "anthropic/claude-haiku-4-5"  // Modèle par défaut (rapide et économique)
    }
  },
  models: {
    providers: {
      openrouter: {
        apiKey: "sk-or-v1-VOTRE_CLE_ICI"
      }
    }
  }
}

💡 Choix du modèle :
- anthropic/claude-haiku-4-5 : Rapide, économique (~0.25$/M tokens). Idéal pour les tâches courantes.
- anthropic/claude-sonnet-4 : Plus puissant, bon compromis qualité/prix.
- anthropic/claude-opus-4 : Le plus capable, pour les tâches complexes. Plus cher.

Vous pouvez changer de modèle à la volée avec la commande /model dans le chat.

Étape 7 : Connecter Telegram

Telegram est le canal le plus simple à configurer avec OpenClaw.

Créer un bot Telegram

1. Ouvrez Telegram et cherchez @BotFather
2. Envoyez /newbot
3. Choisissez un nom (ex: "Mon Agent IA")
4. Choisissez un username (ex: mon_agent_ia_bot)
5. BotFather vous donne un token — copiez-le précieusement

Configurer le bot dans OpenClaw

openclaw config set channels.telegram.token "VOTRE_TOKEN_TELEGRAM"

Pour restreindre l'accès à votre bot (fortement recommandé) :

openclaw config set channels.telegram.allowFrom '["VOTRE_ID_TELEGRAM"]'

💡 Trouver votre ID Telegram : Envoyez un message à @userinfobot sur Telegram, il vous donnera votre ID numérique.

Ou éditez directement la configuration :

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      model: "anthropic/claude-haiku-4-5"
    }
  },
  models: {
    providers: {
      openrouter: {
        apiKey: "sk-or-v1-VOTRE_CLE_ICI"
      }
    }
  },
  channels: {
    telegram: {
      token: "VOTRE_TOKEN_TELEGRAM",
      allowFrom: ["VOTRE_ID_TELEGRAM"]
    }
  }
}

⚠️ Sécurité : Sans allowFrom, n'importe qui peut parler à votre bot et potentiellement exécuter des commandes sur votre serveur. Configurez toujours cette restriction.

Étape 8 : Premier test

Démarrez le Gateway :

openclaw gateway start

Vérifiez qu'il tourne :

openclaw gateway status

Et vérifiez la santé globale :

openclaw health

Maintenant, ouvrez Telegram et envoyez un message à votre bot. Si tout est bien configuré, il devrait répondre !

Test rapide

Envoyez ces messages pour vérifier que tout fonctionne :

1. "Bonjour, qui es-tu ?" → Il devrait se présenter
2. "Quelle heure est-il ?" → Il devrait donner l'heure du serveur
3. "Crée un fichier test.txt avec 'Hello World'" → Il devrait créer le fichier
4. "Lis le fichier test.txt" → Il devrait afficher le contenu

Si ça marche, félicitations 🎉 — votre agent IA est opérationnel !

Étape 9 : Service systemd (fonctionnement permanent)

Pour que OpenClaw tourne en permanence et redémarre automatiquement :

Installation automatique du service

openclaw service install

Cette commande crée et active un service systemd pour vous.

Vérification

# Vérifier le statut du service
systemctl status openclaw

# Voir les logs en temps réel
journalctl -u openclaw -f

# Ou via OpenClaw directement
openclaw logs -f

Commandes utiles

# Redémarrer le service
openclaw gateway restart

# Arrêter le service
openclaw gateway stop

# Démarrer le service
openclaw gateway start

Le service se relancera automatiquement en cas de crash et au redémarrage du serveur.

Étape 10 : Diagnostics et dépannage

La commande magique : openclaw doctor

openclaw doctor

Cette commande vérifie tout :
- Version de Node.js
- Configuration valide
- Connectivité des canaux
- État du workspace
- Problèmes connus

Si des problèmes sont détectés :

openclaw doctor --fix

Problèmes courants

Le bot ne répond pas sur Telegram

1. Vérifiez que le Gateway tourne : openclaw gateway status
2. Vérifiez les logs : openclaw logs | tail -50
3. Vérifiez le token Telegram : est-il correct dans la config ?
4. Vérifiez allowFrom : votre ID y est-il ?

Erreur "model not found"

1. Vérifiez votre clé OpenRouter : openclaw config get models
2. Vérifiez que vous avez des crédits sur OpenRouter
3. Essayez un autre modèle : /model anthropic/claude-haiku-4-5

Le Gateway ne démarre pas

# Voir les erreurs détaillées
openclaw logs --level error

# Vérifier la configuration
openclaw doctor

# Réinitialiser si nécessaire
openclaw doctor --fix

Commande openclaw introuvable après installation

Si après l'installation openclaw n'est pas trouvé dans un nouveau terminal :

npm config get prefix

Notez le chemin retourné. Si openclaw n'est pas dans votre PATH, ajoutez-le :

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc

Puis rechargez la configuration :

source ~/.bashrc

Logs utiles

# Logs complets
openclaw logs

# Logs en temps réel
openclaw logs -f

# Logs filtrés par niveau
openclaw logs --level error
openclaw logs --level warn

Résumé des commandes

Voici un récapitulatif de toutes les commandes utilisées :

# Installation
curl -fsSL https://openclaw.ai/install.sh | bash
# ou
npm install -g openclaw@latest

# Configuration
openclaw setup
openclaw onboard --install-daemon
openclaw doctor

# Gestion du Gateway
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status

# Service systemd
openclaw service install
systemctl status openclaw

# Diagnostics
openclaw doctor
openclaw doctor --fix
openclaw health
openclaw logs -f

Et maintenant ?

Votre agent est installé et fonctionne. Voici les prochaines étapes :

1. Personnaliser votre agent : Éditez SOUL.md, AGENTS.md et USER.md pour que l'agent vous connaisse vraiment → Configurer OpenClaw : SOUL, AGENTS et Skills
2. Sécuriser votre installation : Mettez en place les bonnes pratiques de sécurité → Sécuriser OpenClaw
3. Automatiser votre vie : Découvrez les heartbeats et les crons → Automatiser sa vie avec OpenClaw

Bienvenue dans le monde des agents IA personnels. Votre assistant ne dort jamais. 🐾

📚 Pour aller plus loin

• Qu'est-ce qu'OpenClaw ? L'agent IA qui change tout — Découvrez en détail les concepts clés d'OpenClaw et ses cas d'usage avant d'approfondir l'installation.
• Configurer OpenClaw : SOUL, AGENTS et Skills — Une fois installé, apprenez à paramétrer les composants essentiels pour exploiter tout le potentiel de votre agent IA.
• Sécuriser son installation OpenClaw — Protégez votre VPS et votre agent contre les vulnérabilités courantes avec des bonnes pratiques testées.
• VPS + IA : le setup complet pour tout auto-héberger — Optimisez votre infrastructure avec des conseils avancés sur l'hébergement d'applications IA (backups, monitoring, etc.).
  "
  }
  ```