Aller au contenu

Exécuter dans la CLI

Cette page vous guide de zéro jusqu’à un bot en fonctionnement. Aucune expérience préalable du projet n’est nécessaire. Si un terme n’est pas clair, consultez les pages Concepts.

Avant de commencer

Vous avez besoin de deux éléments fournis par Telegram :

  1. Un jeton de bot. Ouvrez une conversation avec @BotFather, envoyez /newbot, suivez les instructions et copiez le jeton reçu. Il ressemble à 123456789:AAExampleTokenValue.
  2. Votre identifiant utilisateur numérique. Il s’agit d’un nombre, pas de votre @username. Si vous ne le connaissez pas, le bot vous l’indiquera lors de votre premier message (voir l’étape 5).

Étape 1 : télécharger

Téléchargez l’archive de la version et extrayez-la.

Télécharger et ouvrir le dossier de la version

Télécharger et extraire la version
wget -O telegram-commander.tar.gz https://github.com/azolfagharj/telegram-commander/releases/latest/download/telegram-commander.tar.gz
tar -xzf telegram-commander.tar.gz
cd telegram-commander

Le dossier contient :

Étape 2 : choisir le fichier exécutable

Quel fichier convient à votre machine ?

La plupart des serveurs et PC utilisent amd64 (aussi appelé x86_64). Les petites cartes ARM et certaines machines virtuelles utilisent arm64.

En cas de doute, exécutez uname -m : x86_64 signifie amd64 et aarch64 signifie arm64.

Conserver le programme amd64
mv telegram-commander-linux-amd64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-arm64
Conserver le programme arm64
mv telegram-commander-linux-arm64 telegram-commander
chmod +x telegram-commander
rm telegram-commander-linux-amd64

Vous disposez maintenant d’un seul programme nommé telegram-commander.

Étape 3 : créer la configuration

Copiez l’exemple minimal dans un fichier de travail. Il ouvre la catégorie System Status avec trois boutons en lecture seule : Uptime, Memory et Disk Space. Il n’y a pas de bouton pour taper une commande libre.

Créer une configuration modifiable

Copier l’exemple de configuration
cp config-examples/config.minimal.yaml ./config.yaml

Ouvrez config.yaml et remplacez deux valeurs :

  • YOUR_BOT_TOKEN — le jeton de BotFather
  • YOUR_USER_ID — votre identifiant numérique (ou laissez-le pour l’instant et consultez l’étape 5)

Pour connaître chaque réglage, consultez Configuration.

Étape 4 : valider

Vérifiez toujours la configuration avant le lancement. Cela détecte les fautes sans démarrer le bot.

Vérifier que la configuration fonctionne

Valider la configuration
./telegram-commander validate --config config.yaml

Si Valid configuration s’affiche, tout est prêt. Sinon, la commande indique précisément le problème et son emplacement. Consultez la page CLI.

Étape 5 : trouver votre identifiant utilisateur

Si vous ne connaissez pas votre identifiant, définissez seulement le jeton dans config.yaml, placez provisoirement un nombre dans allowed_users, puis lancez le bot :

Démarrer une fois pour voir votre identifiant

Lancer le bot pour connaître votre identifiant
./telegram-commander run --config config.yaml

Dans Telegram, trouvez votre bot et envoyez-lui un message. Comme vous ne figurez pas encore parmi les utilisateurs autorisés, le bot répond avec votre user_id et votre username. Copiez cet identifiant dans allowed_users, arrêtez le bot avec Ctrl+C, puis relancez-le.

Ce comportement fait partie du contrôle d’accès ; consultez Configuration → telegram.

Étape 6 : exécuter

Démarrer le bot dans le terminal

Démarrer le bot
./telegram-commander run --config config.yaml

Ouvrez le bot dans Telegram et envoyez /start. Votre menu doit apparaître. Appuyez sur un bouton pour exécuter sa commande.

Votre bot fonctionne

Le menu décrit dans config.yaml est maintenant dans la conversation et chaque appui exécute sa commande sur cette machine.

Pour garder le bot actif après votre déconnexion du serveur, configurez-le comme service. Consultez Exécuter comme service.

Étape suivante