Connecter Telegram

Créez un bot Telegram pour votre agent et discutez avec lui depuis votre téléphone.

Une fois Telegram connecté, vous pouvez écrire à votre agent depuis votre téléphone, où que vous soyez. Les tâches programmées peuvent aussi vous envoyer leurs résultats par ce biais.

Étape 1 : Créer un bot

  1. Ouvrez Telegram et démarrez une conversation avec @BotFather.
  2. Envoyez /newbot.
  3. Choisissez un nom d’affichage, par exemple Mona.
  4. Choisissez un nom d’utilisateur qui se termine par bot, par exemple mona_assistant_bot.
  5. BotFather répond avec un token de la forme 123456789:AAH.... Copiez-le.

Gardez ce token secret. Toute personne qui le possède peut contrôler votre bot.

Étape 2 : Connecter le bot à votre agent

officeclaws telegram set
Telegram bot token: 123456789:AAH...
Telegram channel configured.

Pour appliquer le nouveau réglage, telegram set redémarre lui-même le conteneur de l’agent : l’agent est donc indisponible pendant quelques secondes. Si vous relancez telegram set sans --dm-policy, le mode repasse à pairing.

Étape 3 : Associer votre compte Telegram

Par défaut, le bot ne parle qu’aux personnes que vous approuvez. Ce mode s’appelle pairing.

  1. Dans Telegram, ouvrez votre bot (recherchez son nom d’utilisateur) et envoyez-lui n’importe quel message.

  2. Le bot répond avec un code d’association.

  3. Sur votre ordinateur, affichez les demandes en attente :

    officeclaws telegram pairings
    CODE      USERNAME  USER-ID     EXPIRES
    K7Q2XM    alex      123456789   2026-10-17T12:30:00Z
    
  4. Approuvez la demande :

    officeclaws telegram approve K7Q2XM
  5. Écrivez de nouveau au bot. Cette fois, l’agent répond.

Notez votre USER-ID. Vous en aurez besoin pour envoyer les résultats des tâches programmées sur Telegram.

Qui peut écrire au bot

Choisissez un mode avec --dm-policy :

officeclaws telegram set --dm-policy pairing
ModeQui peut écrire à l’agent
pairing (par défaut, recommandé)Uniquement les personnes que vous approuvez avec un code d’association
allowlistUniquement les comptes figurant sur la liste autorisée de l’agent
openToute personne qui trouve le bot. Non recommandé. Elle consommerait vos limites ChatGPT.
disabledPersonne. Le bot ignore les messages privés.

Autres commandes

officeclaws telegram show      # current settings (token masked)
officeclaws telegram disable   # turn Telegram off

Étape suivante

Programmer des tâches →