Tutoriel : installer Clawdbot (OpenClaw) sur son PC et le connecter à Telegram – Guide débutant

Les assistants IA “classiques” vivent dans un onglet de navigateur : on pose une question, on obtient une réponse… puis tout disparaît dès qu’on ferme la page. Clawdbot (aussi connu sous le nom OpenClaw) change la donne : c’est un assistant IA auto-hébergé qui tourne sur votre machine, et qui se connecte à des modèles IA (Claude, OpenAI, etc.) pour l’intelligence.

L’intérêt : un assistant qui peut réellement agir, créer des fichiers, écrire du code, automatiser des tâches, et surtout s’intégrer à des outils que vous utilisez déjà, notamment Telegram.

Dans ce tutoriel TechPi, on va installer OpenClaw pas à pas, ajouter une clé API, démarrer le tableau de bord local, puis connecter le bot à Telegram pour votre première conversation.

Ce dont vous avez besoin avant de commencer

1) Un ordinateur (pas besoin de machine dédiée)

Clawdbot ne fait pas tourner un gros modèle IA en local : il lance surtout l’agent et délègue l’intelligence à un fournisseur externe via API. Résultat : pas besoin d’un PC très puissant.

2) Un fournisseur IA + une clé API

Vous devez choisir un fournisseur et récupérer une API key :

• Anthropic (Claude)

• OpenAI (modèles OpenAI)

Clawdbot est gratuit, mais les requêtes API sont facturées par le fournisseur selon le modèle choisi et votre usage.

3) Node.js (souvent installé automatiquement)

Selon votre installateur, Node.js peut être installé pendant la procédure. Sinon, installez une version récente de Node.js (idéalement la dernière LTS).

Étape 1 — Installer Clawdbot / OpenClaw

Les commandes ci-dessous sont celles qu’on voit le plus souvent dans les installations “one-line”. Si votre page d’installation officielle affiche une commande différente, utilisez celle du site (elle sera la plus à jour).

Sur macOS / Linux

Ouvrez un terminal et lancez la commande d’installation fournie par le projet (souvent un script install.sh).

Exemple (format très courant) :

Sur Windows

Deux options :

Option A (recommandée) : WSL2 (Ubuntu)

1. Activez WSL2 et installez Ubuntu

2. Ouvrez le terminal Ubuntu

3. Lancez la commande Linux (ci-dessus)

Option B : PowerShell

Exemple (format très courant) :

Étape 2 — Lancer l’onboarding (configuration guidée)

Une fois l’installation terminée, lancez l’assistant de configuration :

Pendant l’onboarding, vous passerez généralement par ces étapes :

1. Avertissement de sécurité
   Acceptez pour continuer (l’outil peut exécuter des actions, c’est normal que ce soit puissant).

2. Mode de démarrage
   Choisissez Quick Start (idéal pour débuter).

3. Choix du provider IA
   Sélectionnez Anthropic ou OpenAI selon la clé que vous avez.

4. Saisie de la clé API
   Collez la clé API quand le terminal la demande.

5. Choix du modèle par défaut
   Prenez un modèle équilibré (moins cher qu’un modèle premium, mais suffisamment qualitatif). Vous pourrez changer plus tard.

Étape 3 — Démarrer le Gateway et ouvrir le tableau de bord local

Clawdbot tourne généralement via un “gateway” (service local) et un dashboard web en local.

Vérifier l’état

Lancer (si nécessaire)

Exemple de lancement manuel :

Ouvrir le dashboard

Vous devriez accéder à une interface web locale (souvent sur une adresse du type http://127.0.0.1:18789/) pour voir :

• l’historique des conversations

• l’état du bot

• les paramètres

Conseil : gardez le dashboard local (évitez de l’exposer sur Internet).

Étape 4 — Connecter Clawdbot à Telegram

L’objectif : parler à votre assistant depuis votre téléphone, tout en gardant l’agent sur votre PC.

4.1 Créer un bot Telegram (BotFather)

1. Dans Telegram, cherchez BotFather

2. Créez un nouveau bot

3. Récupérez le token (il ressemble à 123456:ABC-DEF…)

4.2 Ajouter le token côté Clawdbot

Vous avez plusieurs méthodes. Voici la plus simple.

Méthode A : via l’onboarding / dashboard (recommandé)

Si l’onboarding propose l’intégration Telegram, activez-la et collez le token.

Méthode B : via variable d’environnement

macOS / Linux :

Windows PowerShell :

Ensuite, relancez le gateway si nécessaire.

4.3 Tester la connexion

1. Ouvrez votre bot Telegram

2. Envoyez /start

Si tout est correct, le bot répond et vous pouvez commencer à discuter.

Si Telegram demande une validation (pairing)

Selon la configuration, Clawdbot peut exiger une approbation des nouveaux contacts (sécurité). Exemples de commandes utiles :

Étape 5 — Première conversation utile

Pour vérifier que tout fonctionne vraiment, testez trois choses :

1) Mémoire et contexte

• “Je suis développeur web, je travaille sur X. Retient-le.”

• Revenez plus tard : “Tu te souviens de mon projet ?”

2) Création de fichiers

• “Crée un fichier todo.md avec 10 tâches pour mon projet.”

• Vérifiez sur votre machine.

3) Aide pratique

• “Écris une fonction Node.js qui valide un email, plus des tests.”

Bonus — Activer la recherche web (optionnel)

Si vous voulez que Clawdbot fasse de la recherche à jour (au lieu de se limiter aux connaissances du modèle), vous devrez généralement configurer un fournisseur de recherche (ex : Brave Search) dans la section web.

Exemple :

Sécurité : bonnes pratiques simples

Clawdbot peut exécuter des actions. Gardez ces règles :

• N’installez pas d’extensions ou de skills dont vous ne comprenez pas la provenance

• Méfiez-vous des commandes obfusquées ou des scripts non expliqués

• Limitez les permissions (ne donnez pas accès à tout votre disque si ce n’est pas nécessaire)

• Gardez le dashboard en local

• Faites un audit de sécurité quand vous ajoutez des intégrations

Exemples de commandes utiles :

Dépannage rapide

Le bot Telegram ne répond pas

• Vérifiez le token

• Vérifiez que le gateway tourne

• Vérifiez s’il faut approuver l’utilisateur (pairing)

Le dashboard ne s’ouvre pas

• Le port est peut-être occupé : changez le port (–port 18789 vers un autre)

• Le gateway n’est pas lancé : relancez openclaw gateway

Windows : installation instable

• Passez par WSL2 (souvent plus fiable pour ce type d’outils)

Conclusion

Avec Clawdbot (OpenClaw), vous obtenez un assistant IA local qui ne se limite pas à discuter : il peut s’intégrer à Telegram, manipuler des fichiers, automatiser des tâches et devenir un vrai copilote au quotidien. Une fois l’installation et les clés configurées, l’usage devient très fluide : vous écrivez simplement à votre bot, et il agit depuis votre machine.