Intégration de Clawdbot avec Telegram

Aperçu de l'Intégration Clawdbot Telegram

L'intégration Clawdbot Telegram vous permet de connecter votre assistant IA personnel à Telegram en utilisant l'API Bot via grammY. C'est prêt pour la production pour les DMs de bots et les groupes, avec long-polling par défaut et support optionnel de webhook.

Pourquoi Utiliser Clawdbot avec Telegram ?

Telegram offre des APIs de bots puissantes et des fonctionnalités de confidentialité. Intégrer Clawdbot avec Telegram offre :

Configuration Rapide (Débutant)

1. Créez un bot avec @BotFather (lien direct)
2. Confirmez que le handle est exactement @BotFather, puis copiez le token
3. Définissez le token via env (TELEGRAM_BOT_TOKEN=...) ou config (channels.telegram.botToken)
4. Démarrez la passerelle
5. L'accès DM est par appairage par défaut ; approuvez le code d'appairage au premier contact

Configuration minimale :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing"
    }
  }
}

Configuration de Clawdbot Telegram

Prérequis

Avant de connecter Clawdbot à Telegram, assurez-vous d'avoir :

• Clawdbot installé sur votre appareil
• Un compte Telegram
• Un Token de Bot Telegram de @BotFather

Étape 1 : Créer un Bot Telegram

Créez un bot via le BotFather de Telegram :

1. Ouvrez Telegram et chattez avec @BotFather (lien direct)
2. Confirmez que le handle est exactement @BotFather
3. Exécutez /newbot, puis suivez les invites (nom + nom d'utilisateur se terminant par bot)
4. Copiez le token et stockez-le en sécurité

Paramètres optionnels de BotFather :

• /setjoingroups — autoriser/refuser l'ajout du bot aux groupes
• /setprivacy — contrôler si le bot voit tous les messages du groupe

Étape 2 : Configurer le Token

Définissez le token via variable d'environnement ou config :

Variable d'environnement :

TELEGRAM_BOT_TOKEN=123:abc

Fichier de configuration (~/.clawdbot/clawdbot.json) :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Si env et config sont tous deux définis, config a la priorité.

Étape 3 : Démarrer la Passerelle

clawdbot gateway --port 18789

Telegram démarre quand un token est résolu (config d'abord, env en secours).

Étape 4 : Vérifier la Connexion

Vérifiez le statut de votre Clawdbot Telegram :

clawdbot channels status telegram

Token + Confidentialité + Permissions

Création du Token (BotFather)

• /newbot crée le bot et retourne le token (gardez-le secret)
• Si un token fuite, révoquez/régénérez via @BotFather et mettez à jour votre config

Visibilité des Messages de Groupe (Mode Confidentialité)

Les bots Telegram sont par défaut en Mode Confidentialité, ce qui limite les messages de groupe qu'ils reçoivent. Options :

1. Désactivez le mode confidentialité avec /setprivacy
2. Ajoutez le bot comme admin du groupe (les bots admin reçoivent tous les messages)

Note : Quand vous basculez le mode confidentialité, Telegram requiert de retirer + ré-ajouter le bot à chaque groupe pour que le changement prenne effet.

Permissions de Groupe (Droits d'Admin)

Le statut d'admin est défini dans le groupe (UI Telegram). Les bots admin reçoivent toujours tous les messages du groupe.

Fonctionnalités de Clawdbot Telegram

Comment Ça Fonctionne

• Les messages entrants sont normalisés dans l'enveloppe de canal partagée avec contexte de réponse et placeholders de médias
• Les réponses de groupe requièrent une mention par défaut (@mention native ou motifs configurés)
• Les réponses sont toujours routées vers le même chat Telegram
• Long-polling utilise grammY runner avec séquençage par chat

Streaming de Brouillons

Clawdbot peut diffuser des réponses partielles dans les DMs Telegram en utilisant sendMessageDraft.

Prérequis :

• Mode Threaded activé pour le bot dans @BotFather (mode sujet de forum)
• Threads de chat privé uniquement
• channels.telegram.streamMode non défini à "off"

Le streaming de brouillons est pour DM uniquement ; Telegram ne le supporte pas dans les groupes ou canaux.

Formatage (Telegram HTML)

• Le texte sortant Telegram utilise parse_mode: "HTML"
• L'entrée type Markdown est rendue en HTML sûr pour Telegram
• Le HTML brut des modèles est échappé pour éviter les erreurs de parsing Telegram

Commandes

Clawdbot Telegram supporte les commandes personnalisées :

Configuration de Clawdbot Telegram

Exemple de Configuration Complète

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Contrôle d'Accès (DMs + Groupes)

Accès DM :

• dmPolicy: "pairing" — Les expéditeurs inconnus reçoivent un code d'appairage ; approuvez via CLI
• dmPolicy: "allowlist" — Répondre uniquement aux utilisateurs dans la liste autorisée
• dmPolicy: "open" — Répondre à tout le monde (non recommandé)

Accès aux Groupes :

• Définissez channels.telegram.groups par clé d'id de groupe ou "*" pour tous les groupes
• Utilisez requireMention: true pour répondre uniquement quand mentionné

Trouver votre ID Utilisateur Telegram

Utilisez @userinfobot ou des bots similaires pour obtenir votre ID utilisateur Telegram numérique.

Stockage des Identifiants Clawdbot Telegram

Clawdbot stocke les identifiants Telegram de manière sécurisée :

~/.clawdbot/credentials/telegram/bot_token
~/.clawdbot/credentials/telegram/session.json

Vos données Clawdbot Telegram restent sur votre machine locale.

Dépannage Clawdbot Telegram

Bot Ne Répond Pas

Si votre bot Clawdbot Telegram ne répond pas :

1. Vérifiez le token : clawdbot channels verify telegram
2. Vérifiez le statut du bot avec @BotFather
3. Consultez les logs : cat /tmp/clawdbot/telegram.log

Activation de Groupe

Pour activer Clawdbot dans un groupe :

Via config (recommandé) :

{
  "channels": {
    "telegram": {
      "groups": {
        "<group_id>": { "requireMention": true }
      }
    }
  }
}

Via commande (niveau session) : Utilisez /activate dans le chat du groupe.

Obtenir l'ID du Chat de Groupe

Transférez un message du groupe à @userinfobot ou utilisez l'API Telegram.

Meilleures Pratiques Clawdbot Telegram

1. Utilisez le Mode Appairage : Sécurisé par défaut avec des codes d'appairage
2. Configurez le Mode Confidentialité : Configurez dans @BotFather selon vos besoins
3. Gérez les Limites de Taux : Implémentez une limitation de taux appropriée
4. Surveillez l'Utilisation : Suivez les analytiques du bot Clawdbot Telegram

Prochaines Étapes

• Intégration Clawdbot WhatsApp - Connectez Clawdbot à WhatsApp
• Intégration Clawdbot Discord - Configurez Clawdbot sur Discord
• Guide de Configuration Clawdbot - Guide d'installation complet