Aller au contenu
Accueil » Blog » Moltbot (Clawdbot) : installation & premier projet

Moltbot (Clawdbot) : installation & premier projet

    tuto installer moltbot

    En fin de tuto, vous saurez :

    1. Installer Moltbot sur votre serveur Linux (VPS ou local) en moins de 10 minutes
    2. Connecter WhatsApp ou Telegram pour discuter avec votre IA personnelle depuis votre mobile
    3. Créer votre premier agent avec mémoire persistante et accès à vos fichiers

    Résultat concret : Un assistant IA personnel accessible 24/7, qui se souvient de vos conversations et peut exécuter des commandes sur votre serveur.

    Prérequis techniques

    Matériel minimum :

    • VPS Linux (Ubuntu 22.04+ recommandé) ou machine locale
    • 2 Go RAM minimum (4 Go recommandé)
    • 10 Go espace disque
    • Connexion internet stable

    Comptes à créer avant de commencer :

    Connaissances requises :

    • Savoir ouvrir un terminal SSH
    • Copier-coller des commandes
    • Éditer un fichier texte (nano/vim)

    Vous êtes prêt → passons à l’installation.

    1. Installation rapide

    Étape 1.1 : Installation via npm

    Ouvrez votre terminal SSH → tapez :

    # Installation globale de Clawdbot
npm install -g clawdbot

# Vérification de l'installation
clawdbot --version

    Résultat attendu : Vous voyez s’afficher clawdbot v1.x.x dans le terminal.

    Pourquoi : Cette commande installe Clawdbot globalement sur votre système, le rendant accessible depuis n’importe quel répertoire.

    Étape 1.2 : Créer votre workspace

    Créez un dossier dédié pour votre agent → tapez :

    # Création du workspace
mkdir ~/mon-agent-ia
cd ~/mon-agent-ia

# Initialisation
clawdbot init

    Résultat attendu : Le système crée automatiquement les fichiers AGENTS.md, SOUL.md, USER.md, TOOLS.md, IDENTITY.md et HEARTBEAT.md dans votre dossier.

    Pourquoi : Ces fichiers constituent la « personnalité » et la mémoire de votre agent. Clawdbot utilise une approche file-based pour que vous gardiez le contrôle total.

    Étape 1.3 : Première configuration

    Lancez la configuration interactive → tapez :

    clawdbot configure

    Résultat attendu : Un menu interactif apparaît avec plusieurs options. Sélectionnez API Keys en premier.

    Pourquoi : Clawdbot a besoin d’une clé API pour accéder aux modèles IA (Claude, GPT, etc.). Cette étape sécurise votre clé dans le système.

    2. Configuration efficace

    Étape 2.1 : Configurer votre clé API

    Dans le menu de configuration → sélectionnez votre provider :

    # Option 1 : Anthropic (Claude) - recommandé
Provider: Anthropic
API Key: sk-ant-xxxxxxxxxxxxxxxxxxxxx
Model: claude-sonnet-4-5

# Option 2 : OpenRouter (gratuit pour tester)
Provider: OpenRouter
API Key: sk-or-xxxxxxxxxxxxxxxxxxxxx
Model: anthropic/claude-sonnet-4-5

    Résultat attendu : Le système confirme ✓ API key validated successfully.

    Pourquoi : Sans clé API valide, Clawdbot ne peut pas communiquer avec les modèles de langage. Anthropic est recommandé pour la qualité, OpenRouter pour tester gratuitement.

    Étape 2.2 : Personnaliser votre agent

    Éditez le fichier IDENTITY.md → tapez :

    nano IDENTITY.md

    Modifiez le contenu → copiez ceci :

    # IDENTITY.md

- **Name:** MonAssistant
- **Creature:** Assistant personnel spécialisé en tech
- **Vibe:** Efficace, direct, avec une touche d'humour
- **Emoji:** 🤖
- **Notes:** Aide à la productivité, automatisation, et apprentissage IA

    Sauvegardez → Ctrl+O, Enter, puis Ctrl+X.

    Résultat attendu : Votre agent a maintenant une identité claire qui influencera son comportement.

    Pourquoi : L’identité définit comment votre agent se présente et se comporte. C’est votre « persona » IA personnalisée.

    Étape 2.3 : Définir votre profil utilisateur

    Éditez USER.md → tapez :

    nano USER.md

    Ajoutez vos informations → copiez et adaptez :

    # USER.md

- **Name:** [Votre Nom]
- **What to call them:** [Prénom ou surnom]
- **Timezone:** Europe/Paris
- **Language:** Français
- **Notes:** 
  - Développeur / Entrepreneur / [Votre rôle]
  - Intérêts : IA, automatisation, productivité
  - Préfère les réponses courtes et actionnables

    Sauvegardez → Ctrl+O, Enter, puis Ctrl+X.

    Résultat attendu : Votre agent connaît vos préférences et adapte ses réponses à votre contexte.

    Pourquoi : Cette personnalisation permet à l’agent de vous comprendre mieux et d’adapter son ton, sa langue et ses suggestions.

    3. Premier résultat pro

    Étape 3.1 : Démarrer le Gateway

    Lancez le service Clawdbot → tapez :

    clawdbot gateway start

    Résultat attendu : Vous voyez :

    ✓ Gateway started on port 3000
✓ Agent session initialized
✓ Workspace: /home/user/mon-agent-ia

    Pourquoi : Le Gateway est le serveur qui gère les connexions entre vous, votre agent et les canaux de communication (WhatsApp, Telegram, web).

    Étape 3.2 : Accéder à l’interface web

    Ouvrez votre navigateur → allez sur :

    http://VOTRE-IP-VPS:3000

    Résultat attendu : Vous voyez l’interface web Clawdbot avec un chat actif.

    Pourquoi : L’interface web est le moyen le plus rapide de tester votre agent avant de configurer WhatsApp ou Telegram.

    Étape 3.3 : Première conversation

    Dans le chat web → tapez :

    Salut ! Qui es-tu ? Que peux-tu faire pour moi ?

    Résultat attendu : Votre agent répond en se présentant selon l’identité définie dans IDENTITY.md, et liste ses capacités.

    Pourquoi : Cette interaction valide que tout fonctionne : API, configuration, personnalité. Votre agent est maintenant opérationnel.

    Étape 3.4 : Tester la mémoire persistante

    Continuez la conversation → tapez :

    Souviens-toi que mon projet prioritaire est [nom de votre projet]. Quelle est ma priorité ?

    Résultat attendu : L’agent répète correctement votre priorité. Redémarrez le Gateway, reconnectez-vous → demandez à nouveau. L’agent se souvient.

    Pourquoi : Clawdbot stocke la mémoire dans des fichiers markdown (dossier memory/). Contrairement à ChatGPT, vos conversations persistent réellement.

    4. Bonus : Intégration workflow

    Connexion WhatsApp (recommandé)

    Lancez le setup WhatsApp → tapez :

    clawdbot configure --section whatsapp

    Résultat attendu : Un QR code s’affiche dans le terminal.

    Scannez-le depuis WhatsApp → Paramètres → Appareils connectés → Connecter un appareil.

    Pourquoi : Vous pouvez maintenant parler à votre agent depuis votre téléphone, n’importe où, comme si c’était un contact WhatsApp normal.

    Activer les heartbeats (check-ins automatiques)

    Éditez HEARTBEAT.md → tapez :

    nano HEARTBEAT.md

    Ajoutez une checklist → copiez ceci :

    # Tâches à vérifier toutes les heures :
- Lire les emails importants (inbox zéro ?)
- Vérifier le calendrier (événements < 2h)
- État du serveur (CPU, mémoire, disque)

Si tout est OK → HEARTBEAT_OK

    Sauvegardez et configurez la fréquence → tapez :

    clawdbot configure --section heartbeat
# Définir : Interval = 3600 (1 heure)

    Résultat attendu : Toutes les heures, votre agent vérifie proactivement ces points et vous alerte si nécessaire.

    Pourquoi : Les heartbeats transforment votre agent passif en assistant proactif qui surveille vos priorités en arrière-plan.

    Accès aux fichiers et commandes

    Testez l’exécution de commande → dans le chat, tapez :

    Quel est l'état de mon disque dur ? (df -h)

    Résultat attendu : L’agent exécute df -h et vous donne un résumé lisible de l’espace disque.

    Pourquoi : Clawdbot peut lire/écrire des fichiers et exécuter des commandes système. C’est un vrai assistant de productivité, pas juste un chatbot.

    Si ça coince : solutions rapides

    Problème 1 : « npm: command not found »

    Solution :

    # Installer Node.js et npm
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

    Validation : node --version affiche v20.x.x

    Problème 2 : « API key invalid »

    Solution : Vérifiez que votre clé commence bien par sk-ant- (Anthropic) ou sk-or- (OpenRouter). Recréez-en une si nécessaire sur le site du provider.

    Problème 3 : Gateway ne démarre pas (port 3000 occupé)

    Solution :

    # Changer le port dans la config
clawdbot configure --section gateway
# Port: 3001 (ou autre port libre)

    Validation : Accédez à http://VOTRE-IP:3001

    Problème 4 : L’agent ne se souvient de rien

    Solution : Vérifiez que le dossier memory/ existe dans votre workspace :

    ls -la ~/mon-agent-ia/memory/

    Si vide ou absent → créez-le : mkdir -p memory

    Problème 5 : WhatsApp déconnecté après redémarrage

    Solution : Assurez-vous que le Gateway tourne en service permanent :

    # Créer un service systemd
clawdbot gateway install-service
sudo systemctl enable clawdbot
sudo systemctl start clawdbot

    Validation : sudo systemctl status clawdbot affiche « active (running) »

    Vous êtes maintenant opérationnel ! Votre agent Clawdbot est installé, configuré, et accessible 24/7. Il se souvient de vos conversations, peut exécuter des commandes, et vous alerte proactivement.

    Prochaines étapes recommandées :

    • Explorez les skills disponibles : clawdbot skills list
    • Configurez Telegram en plus de WhatsApp pour la redondance
    • Créez des cron jobs pour automatiser des tâches récurrentes
    • Rejoignez la communauté Discord : https://discord.com/invite/clawd

    Ressources :

    Tuto rédigé en janvier 2026 | Testé sur Ubuntu 22.04 LTS | Clawdbot v1.x