Passer au contenu principal
Afficher en Markdown

Telegram

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.

Configuration

À partir du tableau de bord (recommandé)

  1. Ouvrez Paramètres → Canaux de messagerie → Telegram dans le tableau de bord
  2. Envoyez un message à @BotFather sur Telegram, envoyez /newbot, puis suivez les invites pour obtenir un jeton
  3. Envoyez un message à @userinfobot pour obtenir votre ID d'utilisateur numérique
  4. Collez le jeton du bot dans le panneau du tableau de bord
  5. Ajoutez votre ID d'utilisateur à la liste Utilisateurs autorisés
  6. Cliquez sur Enregistrer — la passerelle redémarre et se connecte

Le badge d'état devient vert lorsque la connexion est établie.

À partir de l'interface en ligne de commande

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

Qui peut le rejoindre

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

Commandes

CommandeEffet
/new (ou /start)Démarrer une nouvelle conversation
/compactLibé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 /sessionsRechercher et reprendre une conversation. Ajoutez des mots à la recherche, par exemple /sessions billing; sans mot, Crew liste les dix conversations les plus récentes.
/helpLister les commandes

Configuration

CléPar défautObjectif
telegram.enabledfalseActive le canal
telegram.allowed_user_ids[]ID numériques autorisés à clavarder (vide = personne)
telegram.soft_threshold_pct80Pourcentage 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.

Dépannage

ProblèmeSolution
Aucune réponseVotre ID n'est pas dans allowed_user_ids ou enabled est false
Aucun Telegram channel started dans les journauxLe jeton n'est pas défini ou n'est pas valide
Réponses lentes derrière un proxyDéfinissez HTTPS_PROXY pour le processus de la passerelle
Page mise à jour : 25 septembre 2026