Clawdbot : installer un assistant IA open-source sur ta machine ou VPS

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 :

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 :

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 :

npm install -g clawdbot@latest
# ou avec pnpm
pnpm add -g clawdbot@latest

Ensuite, lance l'onboarding :

clawdbot onboard --install-daemon

• 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 :

# 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 :

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 :

pnpm gateway:watch

Déploiement sur VPS

Pour une disponibilité 24/7, déploie Clawdbot sur un VPS (DigitalOcean, Hetzner, OVH...).

Méthode classique

1. Provisionne un VPS avec Ubuntu 22.04+ et Node 22
2. Installe Clawdbot :

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

1. Configure systemd pour le démarrage automatique :

# Le daemon est automatiquement installé par l'onboarding
systemctl status clawdbot

Avec Docker

Le repo inclut des fichiers Docker :

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

# Lancer le gateway sur un port spécifique
clawdbot gateway --port 18789 --verbose

Configuration

Le fichier de config se trouve dans ~/.clawdbot/clawdbot.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

WhatsApp

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 :

1. Crée un bot sur @BotFather (Telegram) ou Discord Developer Portal
2. Configure le token dans Clawdbot
3. Lance le pairing

Vérifier l'installation

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.