Installation OpenClaw sur Rocky Linux

01

Contexte du projet

OpenClaw est un assistant IA personnel open-source qui permet d'automatiser des tâches vià des canaux de communication (WhatsApp, Telegram, etc.). L'objectif etait de déployer cette solution sur une VM Rocky Linux 9.6 accessible via SSH, avec une configuration sécurisée et un demarrage automatique.

Environnement : VM Rocky Linux 9.6 (192.168.19.238), accès root via SSH.

Technologies utilisées

Rocky Linux 9.6 SSH Node.js 22 npm systemd OpenClaw

Livrables

VM configuree Accès SSH sans mot de passe Service OpenClaw actif Documentation

02

Objectifs du projet

Configurer l'accès SSH par clé (sans mot de passe).

Installer Node.js 22 et les outils de build nécessaires.

Déployer OpenClaw via npm.

Configurer le service systemd pour un demarrage automatique.

03

étapes d'implémentation

étape 1 : Configuration SSH sans mot de passe

Copie de la clé publique SSH vers le serveur pour eviter la saisie du mot de passe a chaque connexion.

# Verification de la cle existante

cat ~/.ssh/id_rsa.pub



# Copie de la cle sur le serveur Rocky

ssh root@192.168.19.238 "mkdir -p ~/.ssh && chmod 700 ~/.ssh"

ssh root@192.168.19.238 "echo 'VOTRE_CLE_PUBLIQUE' >> ~/.ssh/authorized_keys"

ssh root@192.168.19.238 "chmod 600 ~/.ssh/authorized_keys"



# Test de connexion sans mot de passe

ssh root@192.168.19.238 "echo 'Connexion OK'"

étape 2 : Installation des prerequis

Installation de curl, Node.js 22 via NodeSource, Git et les outils de compilation.

# Installation de curl

dnf install -y curl



# Installation de Node.js 22 (via le script officiel OpenClaw)

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



# Ou manuellement via NodeSource :

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

dnf install -y nodejs



# Installation des outils de build (requis pour node-llama-cpp)

dnf groupinstall -y 'Development Tools'

dnf install -y cmake git

étape 3 : Installation d'OpenClaw

Installation globale d'OpenClaw via npm.

# Installation d'OpenClaw

npm install -g openclaw@latest



# Verification de l'installation

openclaw --version

# Resultat: 2026.2.6-3



which openclaw

# Resultat: /usr/bin/openclaw

étape 4 : Configuration du service systemd

Installation du service Gateway pour un fonctionnement en arrière-plan avec demarrage automatique.

# Installation du service systemd

openclaw gateway install --force



# Activation du linger pour les services utilisateur

loginctl enable-linger root



# Activation et demarrage du service

systemctl --user enable openclaw-gateway

systemctl --user start openclaw-gateway



# Verification du statut

systemctl --user status openclaw-gateway

étape 5 : Configuration d'OpenClaw

Lancement de l'assistant de configuration interactif pour configurer les credentials et canaux.

# Lancer la configuration interactive

openclaw configure



# Ou configurer section par section :

openclaw configure --section model      # Configuration du modele IA

openclaw configure --section gateway    # Configuration du gateway

openclaw configure --section channels   # Configuration des canaux (WhatsApp, Telegram...)



# Diagnostics

openclaw doctor



# Voir les logs en temps reel

openclaw logs --follow

04

Guide de configuration

Pour configurer OpenClaw, connectez-vous en SSH au serveur et lancez openclaw configure. L'assistant interactif vous guidera a travers les étapes suivantes :

Gateway Location : Choisir "Local (this machine)" pour executer sur le serveur.

Model Configuration : Configurer la clé API (OpenAI, Anthropic, ou modèle local).

Channels : Connecter WhatsApp Web, Telegram Bot, ou autres canaux.

Workspace : Définir le repertoire de travail de l'agent.

Skills : Activer les compétences (calendrier, rappels, recherche web...).

Commandes utiles

# Verifier l'etat du service

systemctl --user status openclaw-gateway



# Redemarrer le service

systemctl --user restart openclaw-gateway



# Voir les logs

openclaw logs --follow



# Diagnostics complets

openclaw doctor



# Ouvrir le dashboard (via tunnel SSH)

# Depuis votre machine locale :

ssh -L 18789:localhost:18789 root@192.168.19.238

# Puis ouvrir http://localhost:18789 dans votre navigateur

05

Difficultés rencontrees

Echec de l'installation npm : outils de build manquants (cmake, make).

Compilation de node-llama-cpp necessitant les Development Tools.

06

Solutions appliquees

Installation du groupe 'Development Tools' et cmake avant npm install.

Nettoyage du cache npm et reinstallation propre.

07

Resultats et captures

Captures d'écran de l'installation et de la configuration.

Connexion SSH réussie

Installation Node.js

Installation OpenClaw

Service systemd actif

openclaw --version

openclaw configure

Statut final du service :

● openclaw-gateway.service - OpenClaw Gateway (v2026.2.6-3)

     Loaded: loaded (/root/.config/systemd/user/openclaw-gateway.service; enabled)

     Active: active (running)

   Main PID: 45944 (node)

     CGroup: /user.slice/user-0.slice/user@0.service/app.slice/openclaw-gateway.service

             └─45944 /usr/bin/node /usr/lib/node_modules/openclaw/dist/index.js gateway --port 18789

Retour aux projets