Comment Installer Clawdbot sur un VPS

Environ 7 min

Comment Installer Clawdbot sur un VPS

Clawdbot est un assistant IA personnel open-source et auto-hébergé qui se connecte à vos plateformes de messagerie préférées. Contrairement aux assistants IA basés sur le cloud comme ChatGPT, Clawdbot fonctionne entièrement sur votre infrastructure, vous offrant un contrôle total sur vos données et votre vie privée. Dans cet article, nous vous guiderons à travers le processus d’installation de Clawdbot sur un VPS en utilisant Node.js. Nous recommandons d’utiliser LightNode comme fournisseur VPS.

Qu’est-ce que Clawdbot ?

Clawdbot est un assistant IA personnel puissant qui vit dans vos applications et plateformes de messagerie préférées. Il se connecte à WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat, et plus encore, transformant les Large Language Models en un compagnon véritablement personnel et toujours disponible. Ses principales fonctionnalités incluent :

Support multi-plateformes : Fonctionne sur plus de 10 plateformes de messagerie
Mémoire persistante : Se souvient de vos préférences et conversations passées au fil du temps
Actions proactives : Peut effectuer des actions, définir des rappels et envoyer des notifications
Auto-hébergé : Propriété complète des données et contrôle de la confidentialité
Personnalisable : Extensible avec des compétences et outils
Toujours actif : Fonctionne 24/7 sur votre VPS ou machine locale

Prérequis

Avant de commencer, assurez-vous d’avoir :

Un serveur VPS : Vous pouvez choisir parmi divers fournisseurs cloud. Nous recommandons LightNode pour ses excellentes performances et sa couverture mondiale.
Connaissances de base en ligne de commande : Une familiarité avec les commandes terminal sera utile.
Node.js installé : Assurez-vous que Node.js 22 ou supérieur est installé sur votre serveur.
Exigences système minimales : 2 Go de RAM, 1 vCPU, 10 Go d’espace disque (4 Go de RAM recommandés pour un usage en production).

Pourquoi nous recommandons LightNode VPS

LightNode est un excellent choix pour héberger Clawdbot pour plusieurs raisons :

Avantages clés de LightNode

Tarification abordable : Les forfaits commencent à 7,71 $/mois avec facturation horaire, vous permettant de tester sans engagement à long terme.
Plus de 40 emplacements mondiaux : Centres de données sur 6 continents, y compris USA, Europe, Asie, Moyen-Orient et Afrique, garantissant une faible latence pour les utilisateurs du monde entier.
Haute performance : Stockage NVMe SSD et processeurs haute fréquence offrant d’excellentes performances pour les charges IA.
Garantie de disponibilité à 99,95 % : Infrastructure fiable avec accès BGP local assurant que votre assistant est toujours disponible.
Facturation flexible : Payez uniquement ce que vous utilisez avec une facturation horaire, parfait pour tester et évoluer.
Convivial pour les développeurs : Accès root complet, déploiement instantané, et support pour Linux et Windows.
Snapshots gratuits : Un snapshot gratuit par VPS pour des sauvegardes et restaurations faciles.
Bonus nouveau utilisateur : Obtenez jusqu’à 15 $ de crédits gratuits lors de votre premier rechargement.

Configuration LightNode recommandée pour Clawdbot

Composant	Spécification	Coût Mensuel
Forfait	Agency	14,70 $/mois
CPU	2 vCPU	-
RAM	4 Go DDR4	-
Stockage	50 Go NVMe SSD	-
Bande passante	2 To	-
Localisation	Singapour, Hong Kong, ou Silicon Valley	-

Cette configuration fournit des ressources suffisantes pour les opérations de Clawdbot et permet une marge de croissance à mesure que votre utilisation augmente.

Commencez avec LightNode

Étape 1 : Configuration de votre VPS

Lancer une instance : Connectez-vous à LightNode et créez une nouvelle instance VPS. Nous recommandons de choisir un emplacement proche de vos utilisateurs principaux pour une latence optimale. Pour un accès global, Singapour ou Hong Kong sont d’excellents choix pour les utilisateurs asiatiques, tandis que Silicon Valley convient bien aux utilisateurs nord-américains.
Choisir le système d’exploitation : Sélectionnez Ubuntu 22.04 LTS (recommandé) ou Ubuntu 24.04. Ces versions offrent un excellent support de Node.js et sont largement testées.
Accès SSH : Utilisez un client SSH pour accéder à votre serveur :
```
ssh username@your_server_ip
```

Étape 2 : Installation de Node.js

Clawdbot nécessite Node.js version 22 ou supérieure. Voici comment l’installer sur Ubuntu :

# Mettre à jour les listes de paquets
sudo apt update

# Installer Node.js 22 depuis le dépôt NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Vérifier l’installation
node --version
# Doit afficher : v22.x.x

Alternativement, vous pouvez utiliser NVM (Node Version Manager) pour plus de flexibilité :

# Installer NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Installer Node.js 22
nvm install 22
nvm use 22

# Vérifier l’installation
node --version

Étape 3 : Installation de Clawdbot

Plusieurs méthodes d’installation sont disponibles. Choisissez celle qui correspond le mieux à vos besoins.

Méthode 1 : Script d’installation officiel (recommandé pour les débutants)

Le script d’installation est la méthode la plus simple et gère automatiquement les dépendances :

# Télécharger et exécuter le script d’installation
curl -fsSL https://clawd.bot/install.sh | bash

Cette commande va :

Détecter votre système d’exploitation
Vérifier que Node.js 22+ est installé
Installer Clawdbot globalement via npm
Configurer les chemins nécessaires
Exécuter la commande doctor pour vérifier l’installation

Méthode 2 : Installation globale via npm

Pour les utilisateurs à l’aise avec npm :

# Installer Clawdbot globalement
npm install -g clawdbot@latest

# Ou avec pnpm (plus rapide)
pnpm add -g clawdbot@latest

# Vérifier l’installation
clawdbot --version

Méthode 3 : Installation depuis la source (pour développeurs)

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

# Installer les dépendances
pnpm install

# Compiler l’interface utilisateur
pnpm ui:build

# Compiler le projet
pnpm build

# Lancer l’assistant d’installation
./dist/entry.js onboard --install-daemon

Méthode 4 : Installation via Docker (optionnel)

Pour un déploiement conteneurisé :

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

# Exécuter le script de configuration Docker
./docker-setup.sh

Étape 4 : Lancer l’assistant d’installation

Après l’installation, lancez l’assistant d’installation pour configurer Clawdbot :

# Démarrer l’assistant interactif
clawdbot onboard --install-daemon

L’assistant vous guidera à travers :

Configuration de la passerelle : Choisissez le mode passerelle local ou distant et configurez le port de la passerelle (par défaut : 18789).
Configuration de l’authentification : Configurez votre fournisseur de modèle IA.
- Anthropic (Claude) : clé API ou OAuth (recommandé)
- OpenAI (ChatGPT/Codex) : clé API
- Autres fournisseurs : points de terminaison personnalisés et clés API
Configuration des canaux : Configurez les plateformes de messagerie :
- WhatsApp : connexion via QR code
- Telegram : token bot depuis @BotFather
- Discord : token bot depuis le portail développeur Discord
- Slack : OAuth ou token bot
Installation du service : Installez la passerelle comme service en arrière-plan (systemd sous Linux).
Identité de l’agent : Configurez la personnalité et le comportement par défaut de votre assistant.

Étape 5 : Démarrer la passerelle

Après avoir complété l’assistant d’installation, la passerelle devrait démarrer automatiquement. Vous pouvez vérifier son statut avec :

# Vérifier le statut de la passerelle
clawdbot gateway status

# Voir les logs
clawdbot logs --follow

# Vérifier la santé
clawdbot health

Démarrage manuel (si le service ne tourne pas)

# Démarrer la passerelle au premier plan
clawdbot gateway --port 18789 --verbose

Gestion du service

# Démarrer le service
systemctl --user start clawdbot-gateway.service

# Arrêter le service
systemctl --user stop clawdbot-gateway.service

# Redémarrer le service
systemctl --user restart clawdbot-gateway.service

# Activer le service au démarrage
systemctl --user enable clawdbot-gateway.service

# Voir les logs du service
journalctl --user -u clawdbot-gateway -f

Étape 6 : Accéder au tableau de bord

L’interface de contrôle Clawdbot est accessible via votre navigateur web :

http://your_server_ip:18789/

Si vous avez configuré l’authentification lors de l’assistant d’installation, vous devrez fournir le token de la passerelle pour accéder au tableau de bord.

Accès distant via tunnel SSH

Pour un accès distant sécurisé :

# Configurer un tunnel SSH depuis votre machine locale
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Puis accéder localement
http://localhost:18789/

Étape 7 : Connecter votre premier canal

Pour connecter WhatsApp :

# Générer et afficher le QR code
clawdbot channels login

# Scanner avec WhatsApp :
# Paramètres → Appareils liés → Lier un appareil

Après le scan, votre WhatsApp sera connecté à Clawdbot.

Créez un bot en envoyant un message à @BotFather sur Telegram
Suivez les instructions pour créer un nouveau bot
Copiez le token du bot fourni
Ajoutez le bot à Clawdbot :

clawdbot channels add --channel telegram --token "votre_token_bot_ici"

Discord

Rendez-vous sur le portail développeur Discord
Créez une nouvelle application
Activez le bot dans l’onglet « Bot »
Copiez le token du bot
Invitez le bot sur votre serveur Discord avec les permissions appropriées
Ajoutez-le à Clawdbot :

clawdbot channels add --channel discord --token "votre_token_bot_discord"

Étape 8 : Configurer la sécurité des messages privés (DM)

Par défaut, Clawdbot utilise un mode appairage pour les messages privés, ce qui signifie que les expéditeurs inconnus reçoivent un code d’appairage et leurs messages ne sont pas traités tant qu’ils ne sont pas approuvés.

# Lister les demandes d’appairage en attente
clawdbot pairing list whatsapp

# Approuver une demande d’appairage
clawdbot pairing approve whatsapp <code_appairage>

# Voir les appairages approuvés
clawdbot pairing list whatsapp --approved

Vous pouvez modifier ce comportement dans le fichier de configuration situé à ~/.clawdbot/clawdbot.json.

Étape 9 : Tester votre installation

Envoyez un message test pour vérifier que tout fonctionne :

# Envoyer un message test
clawdbot message send --to +15555550123 --message "Bonjour de la part de Clawdbot !"

# Ou tester via Telegram
clawdbot message send --to @votre_nom_utilisateur_telegram --message "Bonjour !"

Alternativement, envoyez un message directement à votre WhatsApp/Telegram/Discord connecté, et votre assistant Clawdbot devrait répondre.

Étape 10 : Configurer Nginx (optionnel)

Pour un usage en production, nous recommandons de configurer un reverse proxy avec Nginx pour renforcer la sécurité et gérer les certificats SSL.

Installer Nginx

sudo apt install -y nginx

Configurer Nginx

Éditez le fichier de configuration Nginx :

sudo nano /etc/nginx/sites-available/clawdbot

Ajoutez la configuration suivante :

server {
    listen 80;
    server_name your-domain.com;  # Remplacez par votre domaine

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Activer la configuration

# Créer un lien symbolique
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Tester la configuration Nginx
sudo nginx -t

# Redémarrer Nginx
sudo systemctl restart nginx

Ajouter SSL avec Certbot (recommandé)

# Installer Certbot
sudo apt install -y certbot python3-certbot-nginx

# Obtenir un certificat SSL
sudo certbot --nginx -d your-domain.com

# Certbot configurera automatiquement Nginx avec SSL

Après cela, votre Clawdbot sera accessible à l’adresse :

https://your-domain.com/

Résolution des problèmes courants

La passerelle ne démarre pas

Si la passerelle ne démarre pas :

# Vérifier les erreurs de configuration
clawdbot doctor

# Voir les logs détaillés
journalctl --user -u clawdbot-gateway -n 50

Erreurs de mémoire insuffisante

Sur un VPS avec 2 Go de RAM, vous pouvez rencontrer des erreurs de mémoire lors des mises à jour. Ajoutez un fichier swap :

# Créer un fichier swap de 2 Go
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Rendre le swap persistant
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Port déjà utilisé

Si le port 18789 est déjà utilisé :

# Trouver ce qui utilise le port
sudo lsof -i :18789

# Ou utiliser un port différent
clawdbot gateway --port 18889

Le bot ne répond pas

Si votre bot ne répond pas :

Vérifiez le statut de la passerelle : clawdbot gateway status
Vérifiez la configuration des canaux : Assurez-vous que les tokens sont corrects et que les canaux sont activés
Vérifiez l’authentification : Assurez-vous que les clés API sont valides
Consultez les logs : clawdbot logs --follow pour rechercher des messages d’erreur

Mise à jour de Clawdbot

Pour mettre à jour vers la dernière version :

# Relancer le script d’installation
curl -fsSL https://clawd.bot/install.sh | bash

# Ou mettre à jour via npm
npm update -g clawdbot@latest

# Redémarrer la passerelle
clawdbot gateway restart

# Vérifier la santé
clawdbot health

Conclusion

Installer Clawdbot sur un VPS est un processus simple qui vous offre un assistant IA puissant, auto-hébergé et accessible sur plusieurs plateformes de messagerie. Avec la tarification abordable, la couverture mondiale et l’infrastructure haute performance de LightNode, vous pouvez déployer votre assistant IA personnel en toute confiance.

En suivant ce guide, vous devriez avoir Clawdbot opérationnel sur votre VPS en environ 20 à 30 minutes, vous offrant un compagnon IA toujours disponible qui respecte votre vie privée et vous donne un contrôle total sur vos données.

Pour une personnalisation plus poussée et des fonctionnalités avancées, consultez la documentation officielle sur la page GitHub de Clawdbot et explorez les discussions communautaires pour des conseils et astuces supplémentaires.

Ressources supplémentaires

Documentation officielle de Clawdbot
Dépôt GitHub de Clawdbot
LightNode VPS - Fournisseur VPS recommandé
Communauté Discord Clawdbot
Marketplace des compétences - Étendez votre assistant avec des compétences supplémentaires