Guide complet pour installer l'assistant IA Clawdbot sur macOS, Linux et Windows. Installation rapide en une commande ou options de configuration manuelle.

Aperçu de l'Installation de Clawdbot

Utilisez l'installateur Clawdbot sauf si vous avez une raison spécifique de ne pas le faire. Il configure la CLI et exécute l'intégration automatiquement.

Installation Rapide (Recommandée)

Installez Clawdbot avec une seule commande :

curl -fsSL https://clawd.bot/install.sh | bash

Windows (PowerShell) :

iwr -useb https://clawd.bot/install.ps1 | iex

Étape suivante (si vous avez sauté l'intégration) :

clawdbot onboard --install-daemon

Configuration Requise

Exigence	Détails
Node.js	Version 22 ou supérieure
Système d'exploitation	macOS, Linux ou Windows via WSL2
pnpm	Requis uniquement si vous compilez depuis les sources

Choisissez votre Méthode d'Installation

1. Script d'Installation (Recommandé)

L'installateur Clawdbot installe globalement via npm et exécute l'intégration :

curl -fsSL https://clawd.bot/install.sh | bash

Options de l'installateur :

curl -fsSL https://clawd.bot/install.sh | bash -s -- --help

Non interactif (sauter l'intégration) :

curl -fsSL https://clawd.bot/install.sh | bash -s -- --no-onboard

2. Installation Globale (Manuelle)

Si vous avez déjà Node.js installé :

npm install -g clawdbot@latest

Si vous avez libvips installé globalement et que sharp échoue :

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g clawdbot@latest

Avec pnpm :

pnpm add -g clawdbot@latest
pnpm approve-builds -g  # approuver clawdbot, node-llama-cpp, sharp, etc.

Ensuite, exécutez l'intégration :

clawdbot onboard --install-daemon

3. Depuis les Sources (Contributeurs/Dev)

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
clawdbot onboard --install-daemon

4. Autres Options d'Installation

Docker : Voir Installation Docker
Nix : Voir Installation Nix
Ansible : Voir Installation Ansible

Après l'Installation

Exécutez ces commandes pour vérifier votre installation de Clawdbot :

# Exécuter l'intégration
clawdbot onboard --install-daemon

# Vérification rapide
clawdbot doctor

# Vérifier l'état de la passerelle
clawdbot status
clawdbot health

# Ouvrir le tableau de bord
clawdbot dashboard

Méthode d'Installation : npm vs git

L'installateur Clawdbot prend en charge deux méthodes :

Méthode	Description
`npm` (par défaut)	`npm install -g clawdbot@latest`
`git`	Cloner/compiler depuis le checkout du code source GitHub

Options CLI :

# npm explicite
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method npm

# Installer depuis GitHub (checkout du code source)
curl -fsSL https://clawd.bot/install.sh | bash -s -- --install-method git

Options courantes :

Option	Description
`--install-method npm\|git`	Choisir la méthode d'installation
`--git-dir <path>`	Répertoire Git (par défaut : ~/clawdbot)
`--no-git-update`	Sauter git pull pour le checkout existant
`--no-prompt`	Désactiver les invites (pour CI/automatisation)
`--dry-run`	Afficher ce qui se passerait
`--no-onboard`	Sauter l'intégration

Variables d'Environnement

Pour l'automatisation, utilisez ces variables d'environnement :

CLAWDBOT_INSTALL_METHOD=git|npm
CLAWDBOT_GIT_DIR=...
CLAWDBOT_GIT_UPDATE=0|1
CLAWDBOT_NO_PROMPT=1
CLAWDBOT_DRY_RUN=1
CLAWDBOT_NO_ONBOARD=1
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1

Dépannage : clawdbot introuvable (PATH)

Diagnostic rapide :

node -v
npm -v
npm prefix -g
echo "$PATH"

Si $(npm prefix -g)/bin n'est pas dans votre PATH, ajoutez-le à votre fichier de démarrage du shell :

macOS / Linux (~/.zshrc ou ~/.bashrc) :

export PATH="$(npm prefix -g)/bin:$PATH"

Windows : Ajoutez la sortie de npm prefix -g à votre variable d'environnement PATH.

Ensuite, ouvrez un nouveau terminal ou exécutez hash -r (bash) / rehash (zsh).

Mise à jour / Désinstallation

Mises à jour : Voir Mise à jour de Clawdbot
Désinstallation : Voir Désinstaller Clawdbot

Étapes Suivantes

Guide de Configuration de Clawdbot - Guide de configuration complet
Passerelle Clawdbot - Configuration de la passerelle
Clawdbot WhatsApp - Se connecter à WhatsApp

Guide d'Installation de Clawdbot