Guide OpenClaw : Installation & Configuration du Homard IA

01

🚀Installation de l'Environnement

OpenClaw est un agent IA modulaire qui tourne sur Node.js. La première étape consiste à se connecter à ton serveur et à déployer l'environnement via le script d'installation officiel.

1

Connexion SSH au serveur

Prends le contrôle de ta machine distante avec ton mot de passe administrateur.

bash — terminal

$ ssh root@TON_IP_SERVEUR

2

Installation automatique

Ce script curl télécharge et configure tout OpenClaw en une commande.

bash — installation

$ curl -sSL https://openclaw.io/install.sh | bash

3

Vérification de l'installation

Confirme que le 🦞 est bien là.

bash — vérification

$ openclaw --version

02

⚙️Configuration de SL2S-Bot

Lance l'assistant interactif pour créer les bases : clés API, modèle IA, et activation des skills.

bash — assistant de config

$ openclaw configure

Lors de la configuration, on a sélectionné Google Gemini 2.0 Flash Lite comme cerveau, et activé les skills WhatsApp (wacli) et Notion.

📂

Le cœur du système : openclaw.json

Tout est stocké dans /root/.openclaw/openclaw.json. Ce fichier est structuré en 4 blocs : Gateway, Models, Channels, et Agents.

Pour éditer manuellement le fichier de configuration :

bash — édition JSON

$ nano /root/.openclaw/openclaw.json

Structure JSON validée pour SL2S-Bot :

json — openclaw.json (structure cible)

{
  "gateway": { /* port 18789, interpréteur désactivé */
    "port": 18789,
    "interpreter": { "enabled": false }
  },
  "models": { /* clé Google AI Studio + Gemini */
    "default": "gemini-2.0-flash-lite"
  },
  "channels": { /* canal WhatsApp */
    "whatsapp": { "phone": "TON_NUMERO" }
  },
  "agents": { /* SL2S-Bot avec ses skills */
    "main": {
      "emoji": "😎",
      "skills": ["wacli", "notion"]
    }
  }
}

03

🛡️Sécurisation « Bunker »

L'installation respecte le principe du Moindre Privilège : l'IA a juste assez de droits pour t'aider, mais pas assez pour te nuire.

bash — isolation et permissions
# Dossier de travail isolé
$ mkdir ~/workspace_ia && cd ~/workspace_ia

# Protéger le fichier de config (clés API, secrets)
$ chmod 600 ~/.openclaw/openclaw.json

Réglages vitaux à injecter dans le JSON pour verrouiller l'IA :

json — sécurité Bunker

"tools": {
  "elevated": { "enabled": false },   // Retire les droits admin
  "sandbox": { "provider": "docker" }    // Isole dans un conteneur
},
"gateway": {
  "auth": { "token": "TON_MOT_DE_PASSE" }  // Protège l'interface
}

bash — audit de sécurité

# Doit afficher 0 critical
$ openclaw security audit

# Vérifier que Docker (la prison) est présent
$ docker --version

💡

Conseil expert

Si tu installes de nouveaux Skills (plugins), relance toujours un openclaw security audit pour vérifier qu'ils n'ouvrent pas une brèche !

04

⚡Mise en Service Permanente

Pour que le bot tourne 24h/24 même quand tu fermes ton PC, il s'exécute en tant que service système en arrière-plan.

bash — gestion du service
# Démarrer le bot
$ systemctl --user start openclaw-gateway.service

# Relancer après modification du JSON
$ systemctl --user restart openclaw-gateway.service

# Arrêter le bot
$ systemctl --user stop openclaw-gateway.service

# Lancement automatique au démarrage du serveur
$ systemctl --user enable openclaw-gateway.service

# Vérifier que le service tourne
$ systemctl --user status openclaw-gateway.service

bash — logs en temps réel

# Voir le cerveau du bot en direct
$ journalctl --user -u openclaw-gateway.service -f

# Voir les 50 dernières lignes d'erreurs
$ journalctl --user -u openclaw-gateway.service -n 50 --no-pager

Pour accéder à l'interface web sans toucher à la console :

Connecte ton PC à Tailscale
Ouvre ton navigateur sur http://100.x.x.x:PORT
Entre ton Token de sécurité

05

🐛Bugs Rencontrés & Solutions

Clique sur chaque problème pour afficher la solution.

🐍

L'IA génère du code Python au lieu d'envoyer un vrai message

▼

✓ SOLUTION

Désactiver l'interpréteur dans le JSON : "interpreter": {"enabled": false} et changer le profil de l'outil en "messaging".

🔧

openclaw doctor écrase tes réglages personnalisés (agents, clés API)

▼

✓ SOLUTION

Toujours conserver une copie de sauvegarde du fichier openclaw.json sur ton PC avant d'utiliser openclaw doctor.

📝

Notion ne répond pas — le bot a la clé mais ne voit aucune page

▼

✓ SOLUTION

Sur Notion (site web) : aller sur la page souhaitée → ... → Connect to → Choisir ton intégration. Sans cette étape, c'est porte close !

{ }

Erreur de syntaxe JSON — une virgule oubliée bloque le démarrage

▼

✓ SOLUTION

Valider le fichier avec jq avant de relancer. Si jq n'est pas installé : apt install jq

bash — validation JSON

$ jq . /root/.openclaw/openclaw.json

06

📖Répertoire des Commandes

bash — toutes les commandes essentielles
# ── ACCÈS & SYSTÈME ─────────────────────────────
ssh root@IP_DU_SERVEUR             # Connexion SSH
openclaw --version                # Version installée
exit                               # Quitter le serveur

# ── INSTALLATION & CONFIG ────────────────────────
curl -sSL https://openclaw.io/install.sh | bash
openclaw configure                # Assistant interactif
openclaw doctor                   # ⚠️ Efface souvent le JSON !

# ── FICHIER JSON ─────────────────────────────────
nano /root/.openclaw/openclaw.json
cat  /root/.openclaw/openclaw.json
jq . /root/.openclaw/openclaw.json # Valider la syntaxe

# ── SERVICE ──────────────────────────────────────
systemctl --user start   openclaw-gateway.service
systemctl --user stop    openclaw-gateway.service
systemctl --user restart openclaw-gateway.service
systemctl --user enable  openclaw-gateway.service
systemctl --user status  openclaw-gateway.service

# ── LOGS & DIAGNOSTIC ────────────────────────────
journalctl --user -u openclaw-gateway.service -f
journalctl --user -u openclaw-gateway.service -n 50 --no-pager
openclaw status
openclaw security audit

# ── AGENTS & SKILLS ──────────────────────────────
openclaw agents list
openclaw skills list
openclaw config set agents.main.skills '["wacli","notion"]'

# ── WHATSAPP ─────────────────────────────────────
openclaw wacli login               # Force le QR Code

# ── MISE À JOUR ──────────────────────────────────
npm config set prefix ~/.local && npm i -g openclaw@latest

07

🔄Workflow de Modification

Suis toujours cet ordre quand tu modifies la configuration du bot :

ÉTAPE 01

✏️

nano openclaw.json

ÉTAPE 02

🔍

jq . (valider)

ÉTAPE 03

🚀

systemctl restart

ÉTAPE 04

📋

journalctl -f

08

✅Check-up Final avant de Partir

Clique sur chaque item pour le cocher. Assure-toi que tout est en vert avant de fermer ton terminal.

openclaw status affiche tout en vert
WhatsApp : le canal est bien lié (QR Code scanné)
Notion : l'intégration est autorisée sur au moins une page
Sauvegarde du openclaw.json effectuée sur ton PC local
openclaw security audit exécuté sans erreur critique
Ouvrir un "New Chat" (+) dans l'interface au prochain retour pour éviter les anciennes erreurs