Telegram est le canal le plus rapide à configurer : un seul jeton de bot, aucun plugiciel, et il fonctionne derrière un pare-feu — Crew se connecte à Telegram, il n'y a donc rien à exposer. Les réponses s'affichent en direct avec des boutons d'options que vous pouvez toucher.
- Ouvrez Paramètres → Canaux de messagerie → Telegram dans le tableau de bord
- Envoyez un message à @BotFather sur Telegram, envoyez
/newbot, puis suivez les invites pour obtenir un jeton - Envoyez un message à @userinfobot pour obtenir votre ID d'utilisateur numérique
- Collez le jeton du bot dans le panneau du tableau de bord
- Ajoutez votre ID d'utilisateur à la liste Utilisateurs autorisés
- Cliquez sur Enregistrer — la passerelle redémarre et se connecte
Le badge d'état devient vert lorsque la connexion est établie.
bash
# Save token to ~/.kiro/crew/.env echo "TELEGRAM_BOT_TOKEN=123456789:AA…" >> ~/.kiro/crew/.env
Dans ~/.kiro/crew/config.json :
json
{ "telegram": { "enabled": true, "allowed_user_ids": [123456789] } }
Ensuite : kirocrew restart
Crew ne parle qu'aux personnes que vous nommez — et seulement en clavardage privé.
- Les ID numériques de confiance vont dans
allowed_user_ids; une liste vide signifie personne - Les messages de groupe sont ignorés — les réponses ne se font que par message privé
- Toute autre personne est ignorée silencieusement et l'événement est enregistré dans le journal d'audit
| Commande | Effet |
|---|---|
/new (ou /start) | Démarrer une nouvelle conversation |
/compact | Libérer du contexte lorsqu'il se remplit |
/steer <msg> | Pendant qu'une réponse est en cours de génération, intégrer ce message au tour actuel |
/queue <msg> | Pendant qu'une réponse est en cours de génération, mettre ce message en attente pour après le tour actuel |
/session ou /sessions | Rechercher et reprendre une conversation. Ajoutez des mots à la recherche, par exemple /sessions billing; sans mot, Crew liste les dix conversations les plus récentes. |
/help | Lister les commandes |
| Clé | Par défaut | Objectif |
|---|---|---|
telegram.enabled | false | Active le canal |
telegram.allowed_user_ids | [] | ID numériques autorisés à clavarder (vide = personne) |
telegram.soft_threshold_pct | 80 | Pourcentage de contexte à partir duquel le bot suggère /compact |
telegram.bot_token | "" | Jeton de repli si TELEGRAM_BOT_TOKEN n'est pas défini |
Privilégiez la variable d'environnement TELEGRAM_BOT_TOKEN plutôt que bot_token — cela garde votre secret hors de config.json.
| Problème | Solution |
|---|---|
| Aucune réponse | Votre ID n'est pas dans allowed_user_ids ou enabled est false |
Aucun Telegram channel started dans les journaux | Le jeton n'est pas défini ou n'est pas valide |
| Réponses lentes derrière un proxy | Définissez HTTPS_PROXY pour le processus de la passerelle |
Page mise à jour : 25 septembre 2026
Telegram