C'est quoi Clawdbot ?
Clawdbot est un projet open-source qui transforme Claude en agent autonome capable d'interagir avec tes canaux de communication : WhatsApp, Telegram, Discord, Slack, Signal, et même iMessage. L'idée ? Un assistant IA toujours disponible qui peut répondre à tes messages, exécuter des tâches, et agir en ton nom.
Le projet tourne via un "Gateway" — un serveur local ou distant qui fait le pont entre les APIs de messagerie et Claude. Tu peux l'installer sur ton Mac, ton PC Linux, ou sur un VPS pour une disponibilité 24/7.
Prérequis
Avant de te lancer :
- Node.js 22 ou supérieur (obligatoire)
- macOS, Linux, ou Windows avec WSL2 (Windows natif non recommandé)
- Une clé API Anthropic, un abonnement OpenAI Code, ou Claude Code
- pnpm (recommandé pour les builds depuis les sources)
Pour vérifier ta version de Node :
``bash node --version # Doit afficher v22.x.x ou supérieur ``
Installation rapide (recommandée)
Sur macOS ou Linux
La méthode la plus simple utilise le script d'installation officiel :
``bash curl -fsSL https://clawd.bot/install.sh | bash ``
Ce script télécharge Clawdbot, l'installe globalement, et lance l'assistant de configuration.
Via npm/pnpm
Si tu préfères un contrôle plus fin :
``bash npm install -g clawdbot@latest # ou avec pnpm pnpm add -g clawdbot@latest ``
Ensuite, lance l'onboarding :
``bash clawdbot onboard --install-daemon ``
Cette commande te guide à travers :
- Le choix du modèle IA (Claude Opus, Sonnet, etc.)
- La configuration de ta clé API
- La connexion aux canaux (WhatsApp, Telegram...)
- L'installation du daemon pour un fonctionnement en arrière-plan
Sur Windows
Windows natif n'est pas officiellement supporté. Utilise WSL2 :
```powershell # Dans PowerShell (administrateur) wsl --install
# Une fois dans WSL2 curl -fsSL https://clawd.bot/install.sh | bash ```
Installation depuis les sources
Pour les développeurs qui veulent contribuer ou customiser :
```bash git clone https://github.com/clawdbot/clawdbot.git cd clawdbot
pnpm install pnpm ui:build pnpm build
pnpm clawdbot onboard --install-daemon ```
Pour le mode développement avec hot-reload :
``bash pnpm gateway:watch ``
Déploiement sur VPS
Pour une disponibilité 24/7, déploie Clawdbot sur un VPS (DigitalOcean, Hetzner, OVH...).
Méthode classique
- Provisionne un VPS avec Ubuntu 22.04+ et Node 22
- Installe Clawdbot :
``bash curl -fsSL https://clawd.bot/install.sh | bash clawdbot onboard --install-daemon ``
- Configure systemd pour le démarrage automatique :
``bash # Le daemon est automatiquement installé par l'onboarding systemctl status clawdbot ``
Avec Docker
Le repo inclut des fichiers Docker :
``bash git clone https://github.com/clawdbot/clawdbot.git cd clawdbot docker-compose up -d ``
Accès distant
Pour accéder à ton instance depuis l'extérieur :
- Tailscale Serve/Funnel : expose ton gateway via HTTPS
- SSH tunnels : pour un accès sécurisé sans exposer de ports
``bash # Lancer le gateway sur un port spécifique clawdbot gateway --port 18789 --verbose ``
Configuration
Le fichier de config se trouve dans ~/.clawdbot/clawdbot.json :
``json { "agent": { "model": "anthropic/claude-opus-4-5" } } ``
Tu peux choisir parmi différents modèles Claude selon tes besoins en termes de coût et de performance.
Connecter tes canaux
``bash clawdbot channels login ``
Scanne le QR code avec ton téléphone pour lier ton compte WhatsApp.
Telegram / Discord
Ces plateformes nécessitent un bot token :
- Crée un bot sur @BotFather (Telegram) ou Discord Developer Portal
- Configure le token dans Clawdbot
- Lance le pairing
Vérifier l'installation
``bash clawdbot status clawdbot health ``
Ces commandes affichent l'état du gateway, les canaux connectés, et la santé générale du système.
Points d'attention
- Bun a des problèmes connus avec WhatsApp et Telegram. Utilise Node pour ces canaux.
- Ne stocke jamais ta clé API en clair dans des fichiers versionnés
- Surveille ta consommation API — un agent autonome peut générer beaucoup de requêtes
Conclusion
Clawdbot ouvre des possibilités intéressantes pour automatiser tes communications. Un assistant IA qui répond à tes messages WhatsApp pendant que tu dors, qui gère tes DM Telegram, ou qui modère ton Discord — tout ça devient possible.
Le projet est activement développé et la communauté est réactive. Si tu cherches à expérimenter avec les agents IA au-delà du simple chat, c'est un bon point de départ.
Tu veux qu'on t'aide à intégrer un agent IA dans tes process ? [Parlons-en](https://deepthix.com#contact).