Moltbot — Tutoriel d’installation (débutant)

Objectif : avoir un bot WhatsApp (Moltbot) qui répond quand vous lui parlez et qui peut faire des actions simples (rappels, recherche web, etc.).

0) Ce qu’il vous faut

• Un petit serveur (VPS) en ligne (Hetzner/OVH/…)
• Un accès SSH (Terminal sur Mac/Linux, ou Windows Terminal)
• WhatsApp sur votre téléphone

1) Se connecter au serveur (SSH)

Sur votre ordinateur :

ssh debian@IP_DU_SERVEUR

2) Installer Clawdbot (Moltbot)

Exécutez :

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

Puis relancez votre terminal/SSH si demandé.

3) Démarrer la gateway

clawdbot gateway start

4) Connecter WhatsApp (QR code)

Dans le serveur :

clawdbot whatsapp login

Scannez le QR code avec WhatsApp (Appareils connectés).

5) Sécuriser (important) : allowlist

But : seuls vos numéros peuvent parler au bot.

Dans `~/.clawdbot/clawdbot.json`, mettre :

• `dmPolicy: "allowlist"`
• `allowFrom: ["+33…"]`

Après modification :

clawdbot gateway restart

6) Test rapide

Depuis un numéro autorisé, envoyez :

• “ping”

Vous devez voir le message arriver côté bot (et vous pouvez configurer des réponses).

7) Activer la recherche web (Brave)

1) Créez une clé Brave Search API : https://api.search.brave.com/

2) Sur le serveur :

mkdir -p ~/.config/clawdbot
nano ~/.config/clawdbot/brave.env

Contenu :

BRAVE_API_KEY=VOTRE_CLE

Puis :

chmod 600 ~/.config/clawdbot/brave.env
mkdir -p ~/.config/systemd/user/clawdbot-gateway.service.d
nano ~/.config/systemd/user/clawdbot-gateway.service.d/brave.conf

Contenu :

[Service]
EnvironmentFile=%h/.config/clawdbot/brave.env

Puis :

systemctl --user daemon-reload
systemctl --user restart clawdbot-gateway.service

8) Une première automatisation (ex: météo)

Exemple : chaque matin 07:00, envoyer la météo.

(À adapter selon votre bot et votre canal.)

Conseils

• Ne mettez pas la gateway sur Internet : loopback + firewall.
• Pour les actions sensibles (email/admin), imposez une confirmation.