Installer OpenClaw (Clawdbot) et le connecter à Telegram

Les assistants IA « classiques » vivent dans un onglet de navigateur : on pose une question, on obtient une réponse… puis tout disparaît. Clawdbot (aussi connu sous le nom OpenClaw) propose une autre approche : c’est un assistant IA auto-hébergé qui tourne sur votre machine et se connecte à des modèles (Claude, OpenAI…) pour l’intelligence. L’intérêt : un assistant qui peut agir, créer des fichiers, écrire du code, automatiser des tâches et s’intégrer à des outils comme Telegram.

Dans ce tutoriel, on installe OpenClaw pas à pas, on ajoute une clé API, on démarre le tableau de bord local, puis on connecte le bot à Telegram.

⚠️ À lire avant de commencer

Cet outil est puissant et comporte des risques réels. Il exécute un script d’installation distant, utilise une clé API facturable (vous payez vos requêtes au fournisseur), et donne à un agent la capacité d’exécuter des actions et manipuler des fichiers sur votre ordinateur, potentiellement pilotable à distance via Telegram. Avant de suivre ce guide : n’exécutez que des commandes issues du site officiel, utilisez de préférence un environnement de test, ne donnez à l’agent que les permissions strictement nécessaires, gardez le tableau de bord en local, et surveillez ce qu’il fait. Si vous ne comprenez pas une commande, ne la lancez pas.

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 l’agent et délègue l’intelligence à un fournisseur externe via API. Pas besoin d’un PC très puissant.

2) Un fournisseur IA + une clé API

Choisissez un fournisseur et récupérez une clé API : Anthropic (Claude) ou OpenAI. Clawdbot est gratuit, mais les requêtes API sont facturées par le fournisseur selon le modèle et votre usage.

3) Node.js (souvent installé automatiquement)

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

Étape 1 — Installer Clawdbot / OpenClaw

Important : vérifiez toujours la commande d’installation exacte sur la page officielle du projet avant de l’exécuter — c’est elle qui fait foi, et les commandes ci-dessous sont données à titre indicatif et doivent être confirmées.

Sur macOS / Linux

Ouvrez un terminal et lancez le script d’installation fourni par le projet :

curl -fsSL https://openclaw.ai/install.sh | bash

Sur Windows

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

Activez WSL2 et installez Ubuntu.
Ouvrez le terminal Ubuntu.
Lancez la commande Linux ci-dessus.

Option B : PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

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

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

openclaw onboard --install-daemon

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

Avertissement de sécurité : acceptez pour continuer (l’outil peut exécuter des actions).
Mode de démarrage : choisissez Quick Start pour débuter.
Choix du provider IA : Anthropic ou OpenAI selon votre clé.
Saisie de la clé API : collez la clé quand le terminal la demande.
Modèle par défaut : prenez un modèle équilibré (moins cher qu’un modèle premium). Vous pourrez changer plus tard.

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

Clawdbot tourne via un « gateway » (service local) et un dashboard web en local.

Vérifier l’état

openclaw gateway status

Lancer (si nécessaire)

openclaw gateway --port 18789 --verbose

Ouvrir le dashboard

openclaw 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 et les paramètres. Conseil : gardez le dashboard en local, ne l’exposez jamais 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)

Dans Telegram, cherchez BotFather.
Créez un nouveau bot.
Récupérez le token (format 123456:ABC-DEF...).

4.2 Ajouter le token côté Clawdbot

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 :

export TELEGRAM_BOT_TOKEN="VOTRE_TOKEN_ICI"

Windows PowerShell :

setx TELEGRAM_BOT_TOKEN "VOTRE_TOKEN_ICI"

Ensuite, relancez le gateway si nécessaire.

4.3 Tester la connexion

Ouvrez votre bot Telegram.
Envoyez /start.

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

Si Telegram demande une validation (pairing)

Selon la configuration, Clawdbot peut exiger d’approuver les nouveaux contacts (sécurité). Commandes utiles :

openclaw pairing list telegram
openclaw pairing approve telegram <code>

Étape 5 — Première conversation utile

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

1) Mémoire et contexte

« Je suis développeur web, je travaille sur X. Retiens-le. » puis, 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 ensuite sur votre machine.

3) Aide pratique

« Écris une fonction Node.js qui valide un email, avec des tests. »

Bonus — Activer la recherche web (optionnel)

Pour que Clawdbot fasse de la recherche à jour, configurez un fournisseur de recherche (ex. Brave Search) dans la section web :

openclaw configure --section web

Sécurité : bonnes pratiques

Clawdbot peut exécuter des actions sur votre machine. 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 sans nécessité.
Gardez le dashboard en local.
Faites un audit de sécurité à chaque nouvelle intégration.

Commandes utiles :

openclaw status
openclaw health
openclaw security audit --deep

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).
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 s’intègre à Telegram, manipule des fichiers et automatise des tâches. Une fois l’installation et les clés configurées, l’usage devient fluide — mais gardez toujours en tête les précautions de sécurité, car un agent qui agit sur votre machine mérite d’être surveillé.