Guide d'installation d'OpenClaw Linux : installer sur Ubuntu, Debian, Fedora et Raspberry Pi

Présentation

Linux est une excellente plate-forme pour exécuter OpenClaw, en particulier pour les serveurs permanents et les déploiements Raspberry Pi. Ce guide couvre l’installation sur les distributions Linux populaires, notamment Ubuntu, Debian, Fedora et Raspberry Pi OS, ainsi que la prise en charge d’ARM64 et la configuration du service systemd.

Pour les instructions générales d’installation, consultez notre guide d’installation complet.

Configuration système requise

Distributions prises en charge

• Ubuntu 20.04+ (LTS recommandé)
• Debian 11+ (Bullseye ou version ultérieure)
• Fedora 34+
• Raspberry Pi OS (basé sur Debian)
• Arch Linux (via AUR ou installation manuelle)
• Autres distributions basées sur Debian/Ubuntu

Configuration matérielle requise

• RAM — 2 Go+ recommandés (1 Go minimum pour Raspberry Pi)
• Stockage — 500 Mo+ pour l’installation, espace supplémentaire pour la mémoire/les données
• CPU — architecture x86_64 ou ARM64
• Réseau — Connexion Internet pour les appels API et les mises à jour

Prérequis logiciels

• Node.js 18+ — Peut être installé automatiquement par le programme d’installation monoligne
• curl — Généralement préinstallé
• git — Facultatif, pour une installation piratable à partir des sources
• systemd — Pour la gestion des services (distributions les plus modernes)

Méthodes d’installation

Méthode 1 : installation en une seule ligne (recommandée)

Le moyen le plus simple d’installer OpenClaw sur Linux :

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

Ce script automatiquement :

• Détecte votre distribution Linux
• Installe Node.js s’il est manquant (via NodeSource ou le gestionnaire de packages de distribution)
• Installe OpenClaw globalement via npm
• Configure les autorisations nécessaires
• Vérifie l’installation

Remarque : Vous pouvez être invité à saisir votre mot de passe (sudo) pour installer Node.js ou les packages système.

Méthode 2 : installation de npm

Si Node.js est déjà installé :

npm i -g openclaw

Vérifiez d’abord la version de Node.js :

node --version

Doit être la version 18.0.0 ou supérieure.

Méthode 3 : Packages spécifiques à la distribution

Ubuntu/Debian (via apt)

Certaines distributions peuvent avoir des packages OpenClaw disponibles :

# Add repository (if available)
curl -fsSL https://openclaw.ai/repo/deb/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/openclaw.gpg
echo "deb [signed-by=/usr/share/keyrings/openclaw.gpg] https://openclaw.ai/repo/deb stable main" | sudo tee /etc/apt/sources.list.d/openclaw.list

# Install
sudo apt update
sudo apt install openclaw

Remarque : Les packages officiels ne sont peut-être pas encore disponibles. Consultez docs.openclaw.ai pour connaître les dernières méthodes d’installation.

Fedora (via dnf)

# Add repository (if available)
sudo dnf install openclaw

Arch Linux (via AUR)

yay -S openclaw
# or
paru -S openclaw

Méthode 4 : Installation piratable (à partir de la source)

Pour les développeurs qui souhaitent modifier la source :

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build

Puis exécutez :

npm run openclaw onboard

Ou créez un lien global :

sudo npm link --global

Installation de Node.js

Ubuntu/Debian

Option 1 : référentiel NodeSource (recommandé)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Option 2 : Packages de distribution

sudo apt update
sudo apt install nodejs npm

Remarque : Les packages de distribution peuvent être obsolètes. NodeSource fournit des versions plus récentes.

Option 3 : nvm (Gestionnaire de versions de nœud)

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

Fedora

sudo dnf install nodejs npm

Ou utilisez NodeSource :

curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo dnf install -y nodejs

Framboise Pi (ARM64/ARMv7)

Système d’exploitation Raspberry Pi (basé sur Debian)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

Pour ARMv7 (32 bits), NodeSource peut ne pas avoir de packages. Utilisez des packages de distribution ou créez à partir des sources.

Alternative : installer via NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18

Configuration post-installation

Après l’installation, configurez OpenClaw :

openclaw onboard

Cette configuration interactive couvre :

1. Configuration du modèle d’IA

Choisissez votre fournisseur d’IA :

Claude Anthropic :

• Claude 3.5 Sonnet (recommandé)
• Claude 3 Opus
• Claude 4

Obtenez votre clé API sur console.anthropic.com.

OpenAI GPT :

• GPT-4o
• GPT-4 Turbo
• GPT-4.1

Obtenez votre clé API sur platform.openai.com.

Modèles locaux :

• Ollama (fonctionne localement, aucune clé API n’est nécessaire)
• LM Studio
• MiniMax

2. Autorisations Linux

OpenClaw peut avoir besoin d’autorisations :- Système de fichiers : accès en lecture/écriture à ~/.openclaw

• Réseau — Pour les appels API et les ponts de discussion
• Commandes système — Si vous utilisez les fonctionnalités de contrôle du système

3. Configuration du pare-feu

Autoriser OpenClaw via le pare-feu :

UFW (Ubuntu/Debian) :

sudo ufw allow 3000/tcp

pare-feu (Fedora/RHEL) :

sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload

Exécution d’OpenClaw

Démarrez le serveur

openclaw

Cela démarre le serveur local et connecte toutes les intégrations configurées.

Exécuter en arrière-plan

Utilisez nohup :

nohup openclaw > ~/.openclaw/logs/output.log 2>&1 &

Ou utilisez screen :

screen -S openclaw
openclaw
# Press Ctrl+A then D to detach

Ou utilisez tmux :

tmux new -s openclaw
openclaw
# Press Ctrl+B then D to detach

Exécuter en tant que service systemd (toujours activé)

Créez un service systemd pour un démarrage automatique :

1. Créer un fichier de service :

   sudo nano /etc/systemd/system/openclaw.service

2. Ajouter une configuration :

   [Unit]
   Description=OpenClaw Personal AI Assistant
   After=network.target
   
   [Service]
   Type=simple
   User=your-username
   WorkingDirectory=/home/your-username
   ExecStart=/usr/bin/openclaw
   Restart=always
   RestartSec=10
   Environment="NODE_ENV=production"
   
   [Install]
   WantedBy=multi-user.target

   Remplacez your-username par votre nom d’utilisateur actuel.

3. Recharger systemd :

   sudo systemctl daemon-reload

4. Activer le service :

   sudo systemctl enable openclaw

5. Démarrer le service :

   sudo systemctl start openclaw

6. Vérifier l’état :

   sudo systemctl status openclaw

7. Afficher les journaux :

   sudo journalctl -u openclaw -f

Utilisation de pm2 (Gestionnaire de processus)

Installez pm2 :

npm i -g pm2

Démarrez OpenClaw :

pm2 start openclaw
pm2 save
pm2 startup

La commande pm2 startup générera automatiquement un service systemd.

Configuration spécifique au Raspberry Pi

Optimisation des performances

Raspberry Pi a des ressources limitées. Optimiser :

1. Utilisez des modèles d’IA plus légers :

   • Les modèles locaux (Ollama) sont plus performants
   • Ou utilisez des modèles cloud plus petits

2. Limiter les opérations simultanées :

   • Configurer OpenClaw pour gérer moins de requêtes simultanées

3. Surveiller les ressources :

   htop

Configuration permanente

Pour Raspberry Pi fonctionnant 24h/24 et 7j/7 :

1. Utilisez le service systemd (voir ci-dessus)
2. Activer la connexion automatique (si nécessaire)
3. Configurer la gestion de l’alimentation :

   sudo raspi-config
   # Navigate to Advanced Options → Wait for Network at Boot

Tunnel Cloudflare (accès externe)

Exposez OpenClaw à Internet en toute sécurité :

1. Installez cloudflared :

   curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64 -o cloudflared
   chmod +x cloudflared
   sudo mv cloudflared /usr/local/bin/

2. Authentifier :

   cloudflared tunnel login

3. Créer un tunnel :

   cloudflared tunnel create openclaw

4. Configurer : Créez ~/.cloudflared/config.yml :

   tunnel: <tunnel-id>
   credentials-file: /home/pi/.cloudflared/<tunnel-id>.json
   
   ingress:
     - hostname: openclaw.yourdomain.com
       service: http://localhost:3000
     - service: http_status:404

5. Exécuter le tunnel :

   cloudflared tunnel run openclaw

6. Ajouter à systemd (pour le démarrage automatique) :

   sudo cloudflared service install

Prise en charge ARM64

OpenClaw fonctionne sur l’architecture ARM64 :

• Mac Apple Silicon (via une machine virtuelle Linux)
• Raspberry Pi 4+ (64 bits)
• Instances AWS Graviton
• Autres serveurs ARM64

L’installation est identique à x86_64. Le programme d’installation en une seule ligne détecte automatiquement l’architecture.

Pour ARMv7 (Raspberry Pi 32 bits), certains packages peuvent ne pas être disponibles. Utilisez des packages de distribution ou créez à partir des sources.

Dépannage

Erreurs d’autorisation refusée

Si vous voyez des erreurs d’autorisation :

sudo npm i -g openclaw

Ou corrigez les autorisations npm :

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Commande introuvable

Si openclaw n’est pas trouvé :

1. Vérifiez le chemin global npm :

   npm config get prefix

2. Ajouter au CHEMIN :

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

3. Redémarrer le terminal

Port déjà utilisé

Changer le port :

openclaw --port 3001

Ou trouvez et tuez le processus :

lsof -ti:3000 | xargs kill
# or
sudo netstat -tlnp | grep :3000
sudo kill <PID>

Problèmes de service systemd

Si le service ne démarre pas :

1. Vérifier les journaux :

   sudo journalctl -u openclaw -n 50

2. Vérifier l’utilisateur : Assurez-vous que le service s’exécute en tant qu’utilisateur correct

3. Vérifiez les autorisations :

   ls -la ~/.openclaw

4. Tester manuellement :

   openclaw

Problèmes spécifiques au Raspberry Pi

Mémoire faible :

# Increase swap
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# Set CONF_SWAPSIZE=2048
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

Performances lentes :

• Utilisez des modèles d’IA plus légers
• Limiter les sessions du navigateur
• Réduire l’utilisation de la mémoire

Conseils sur les performances

Surveillance des ressources

Surveillez le processeur et la mémoire :

htop
# or
top

Surveiller l’utilisation du disque :

df -h
du -sh ~/.openclaw
```### Optimisation

- **Utilisez des modèles locaux** pour de meilleures performances sur le matériel bas de gamme
- **Limiter les sessions du navigateur** pour réduire l'utilisation de la mémoire
- **Configurer la rotation des journaux** pour éviter le remplissage du disque
- **Utilisez un SSD** au lieu d'une carte SD (Raspberry Pi)

## Mise à jour d'OpenClaw

Mise à jour vers la dernière version :

```bash
npm update -g openclaw

Ou réexécutez le programme d’installation :

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

Désinstallation

Supprimer OpenClaw :

npm uninstall -g openclaw

Supprimer la configuration :

rm -rf ~/.openclaw

Arrêtez et supprimez le service systemd :

sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

Prochaines étapes

Maintenant qu’OpenClaw est installé sur Linux :

1. Configurer Always-On — Configurer le service systemd
2. Connectez les applications de chat — WhatsApp, Telegram, Discord
3. Explorer les compétences — Bibliothèque de compétences
4. Lire la FAQ — Questions courantes

Conclusion

Linux est une excellente plate-forme pour OpenClaw, en particulier pour les déploiements permanents et les projets Raspberry Pi. Le programme d’installation en une seule ligne gère la plus grande complexité et l’intégration de systemd facilite son exécution en tant que service.

Pour plus d’aide, consultez notre guide d’installation général ou notre page FAQ. Bonne automatisation sous Linux !