Guide d'Installation

Emplacements de Stockage

Clawdbot sépare la configuration de l'installation :

Cette séparation permet des mises à jour faciles sans casser les configurations personnelles.

Prérequis

• Node.js >= 22
• pnpm (recommandé) ou npm
• Docker (optionnel, pour une configuration conteneurisée)

Méthodes d'Installation

Installation Rapide (Recommandée)

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

Via npm

npm i -g clawdbot
clawdbot setup

Via pnpm

pnpm add -g clawdbot
clawdbot setup

Flux de Travail

Flux de Travail Stable (App macOS)

Pour la plupart des utilisateurs, l'app macOS offre l'expérience la plus simple :

1. Installer - Télécharger et lancer Clawdbot.app
2. Intégration - Compléter l'assistant de configuration
3. Permissions - Accorder l'accès système requis
4. Mode Gateway - S'assurer que Gateway est en mode Local
5. Canaux - Lier les canaux de communication (WhatsApp, Telegram, etc.)
6. Vérifier - Exécuter clawdbot health pour confirmer la configuration

Flux de Travail de Développement

Pour les contributeurs et utilisateurs avancés :

# Cloner le dépôt
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Installer les dépendances
pnpm install

# Démarrer le Gateway de développement avec rechargement à chaud
pnpm gateway:watch

Configurez l'app macOS en mode de connexion Local. L'app se connecte au Gateway en cours d'exécution sur le port configuré (par défaut : ws://127.0.0.1:18789).

Stockage des Identifiants

Notes de Plateforme

macOS

L'app gère le Gateway automatiquement via LaunchAgent.

Linux

Utilise un service utilisateur systemd. Activez le lingering pour empêcher l'arrêt du service lors de la déconnexion :

sudo loginctl enable-linger $USER

Windows (WSL2)

Exécutez Clawdbot dans WSL2 avec une distribution Linux. La configuration est identique à Linux.

Stratégie de Mise à Jour

Conservez le contenu personnel dans les répertoires ~/.clawdbot/ séparé de l'installation :

# Mettre à jour via npm
npm update -g clawdbot

# Ou récupérer le dernier code source
cd clawdbot
git pull
pnpm install

Votre espace de travail et votre configuration restent intacts entre les mises à jour.

Vérification de Santé

Vérifiez votre installation :

clawdbot health

Sortie attendue :

• Statut du Gateway : En cours d'exécution
• Port : 18789
• Canaux : Connectés
• Agent : Prêt

Dépannage

Le Gateway Ne Démarre Pas

1. Vérifiez si le port 18789 est utilisé : lsof -i :18789
2. Consultez les logs : cat /tmp/clawdbot/gateway.log
3. Réinitialiser la configuration : clawdbot configure --reset

Problèmes de Connexion des Canaux

1. Ré-authentifier : clawdbot channels login
2. Vérifier les identifiants : ls ~/.clawdbot/credentials/
3. Vérifier l'allowlist : Consulter clawdbot.json

Prochaines Étapes

• Assistant d'Intégration - Configuration guidée
• Appairage - Contrôle d'accès
• Assistant Personnel - Construisez votre assistant