OpenClaw : l’assistant IA “self‑hosted” orienté action

OpenClaw est un assistant IA personnel open‑source conçu pour tourner sur macOS, Linux ou Windows (avec une préférence marquée pour WSL2 côté Windows) et pour être piloté via un CLI et un “gateway” capable de se connecter à des canaux de messagerie. L’idée centrale est simple : tu discutes (WhatsApp/Telegram/Discord/Slack, etc.), et l’agent exécute des tâches via des skills et des workflows, tout en gardant la main sur l’installation et l’environnement.

Concepts clés (Gateway, channels, skills, workflows)

Le “gateway” est le cœur runtime : il gère l’état, les connexions (channels) et l’exécution d’actions, puis expose aussi un tableau de bord (UI) quand tu en as besoin. OpenClaw s’installe principalement via un script d’installation qui gère la détection/installation de Node.js et lance un wizard d’onboarding pour configurer workspace, channels et skills.

Points à comprendre avant de commencer : - “Onboarding” : assistant de configuration guidée (recommandé au premier lancement). - “Skills” : connecteurs/outils que l’agent peut appeler (web, système, APIs, etc.). - “Workflows Lobster” : fichiers “.lobster” dédiés aux automatisations (pipeline d’étapes, approvals, exécution contrôlée).

Tutoriel d’installation (Windows, macOS, Linux)

Pré‑requis officiels : Node 22+ (le script peut l’installer), macOS/Linux/Windows, et pnpm seulement si tu compiles depuis les sources. playbooks Sur Windows, l’équipe recommande fortement d’exécuter OpenClaw sous WSL2 (plutôt que “pur Windows”) pour une expérience plus stable.

A) Linux (recommandé)

1) Ouvre un terminal.
2) Lance l’install “one‑liner” (installe le CLI et peut lancer l’onboarding) :

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

Cette méthode gère Node si nécessaire et enchaîne sur l’onboarding. 3) Vérifie que tout est OK :

openclaw doctor
openclaw status
openclaw dashboard

Ces commandes servent à diagnostiquer la config, vérifier l’état du gateway et ouvrir l’UI. Alternative (si tu préfères gérer Node toi‑même) :

npm install -g openclaw@latest
openclaw onboard --install-daemon

Ce flux est documenté comme option “npm/pnpm” quand Node 22+ est déjà présent.

B) macOS

1) Terminal macOS (zsh).
2) Installation script (même commande que Linux) :

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

Le script supporte macOS et peut installer Homebrew si nécessaire, puis s’assure d’avoir Node.js 22+.

3) Après l’installation :

openclaw doctor
openclaw status
openclaw dashboard

Ces commandes font partie du “After install” recommandé.

C) Windows (deux approches)

Approche 1 — WSL2 (recommandée) : installe WSL2 + une distro Ubuntu, puis suis exactement la procédure Linux dans le terminal Ubuntu. Approche 2 — PowerShell natif : ouvre PowerShell et lance le script officiel :

iwr -useb https://openclaw.ai/install.ps1 | iex

Ce script installe Node si besoin, installe OpenClaw via npm (par défaut) ou via une méthode git, et peut enchaîner l’onboarding.

Si tu veux installer sans lancer l’onboarding (utile en CI/automatisation) : - macOS/Linux/WSL : --no-onboard est supporté par le script shell.

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

Premier démarrage : onboarding, UI, santé du système

Le chemin “propre” consiste à exécuter l’onboarding (wizard) afin de configurer le gateway, le workspace, les channels et les skills sans bricolage manuel. github Ensuite, garde un trio de commandes réflexes : openclaw doctor (diagnostic), openclaw status (état), openclaw dashboard (UI web). Dépannages fréquents (surtout après install globale npm) : - “openclaw not found” : c’est souvent un souci de PATH, car le répertoire des binaires npm globaux n’est pas dans ta variable PATH. - Diagnostic rapide recommandé : node -v, npm -v, npm prefix -g, puis compare avec ton PATH.

Bonnes pratiques (pro, sécurité, maintenance)

Privilégie une séparation claire entre “agent” et “système” : exécute en utilisateur non‑admin, active des confirmations (approvals) pour les actions sensibles, et évite de donner à l’agent un accès shell illimité sans garde‑fous. Tutoriel Si tu veux des installs reproductibles (serveur/VPS/CI), utilise les flags non‑interactifs (no‑prompt/no‑onboard) et documente ta version (dist‑tag/version) pour éviter les surprises lors des mises à jour.