TeleClaude pour Claude Code dans Telegram

TeleClaude : Bot Telegram auto-hébergé pour sessions Claude Code isolées

Après l'arrêt d'OpenClaw, les développeurs ont perdu l'accès à Claude Code via Telegram. TeleClaude résout ce problème : une application TypeScript sur Bun qui lance des processus locaux Claude Code CLI, en routant les messages des sujets de super-groupes vers des répertoires de projets isolés. Elle utilise l'authentification OAuth de votre propre abonnement Claude — sans intermédiaires.

Architecture et routage

TeleClaude s'intègre à l'API Telegram Bot via Grammy. Chaque message d'un sujet de super-groupe déclenche un processus Claude Code dédié avec son propre dossier de projet. Elle gère la continuité des sessions, la compression de contexte et la déduplication de mémoire.

API Telegram Bot → Routeur Grammy → Gestionnaire de processus → Claude Code CLI (par sujet)

Composants clés :

• Routage par sujet avec injection de contexte.
• Gestionnaire de processus avec TTL, limites de concurrence et nettoyage.
• Mémoire basée sur fichiers : SOUL.md (personnalité), main-memory.md (base de connaissances partagée), topic-memory.md (historique du projet).

Système de mémoire et niveaux

La mémoire est structurée en trois niveaux pour préserver le contexte entre les sessions :

project/
├── SOUL.md              # Style de communication, règles
├── main-memory.md       # Lien symbolique vers base de connaissances partagée
├── topic-memory.md      # Historique du projet mis à jour automatiquement
└── memory/
    ├── people/
    ├── services/
    ├── shared/
    └── projects/

Claude Code met à jour topic-memory.md de manière autonome. Au redémarrage ou à la réinitialisation de session, le contexte est rechargé depuis les fichiers. La déduplication supprime périodiquement les doublons entre fichiers.

Automatisation des projets et compression

Un nouveau sujet dans le super-groupe crée automatiquement un répertoire à partir des templates/. Le bot lie SOUL.md, main-memory.md et initialise la mémoire. Le premier message lance Claude Code avec le contexte complet prêt.

La compression s'active près des limites de contexte : faits clés sauvés en mémoire, session réinitialisée. Utilisez /compact pour déclencher manuellement.

Fonctionnalités de TeleClaude

• Routage par sujet : Processus et répertoires isolés.
• Mémoire persistante : Trois niveaux avec accès inter-projets.
• Création auto de projets : Templates pour nouveaux sujets.
• Messages vocaux : Transcription locale Whisper en option.
• Streaming : Indicateur de frappe et mises à jour incrémentales.
• Modèles : Opus, Sonnet, Haiku, ou locaux via Claude Code.
• Gestion : TTL, limites, arrêts de processus.

Installation et configuration

Prérequis : Bun 1.0+, Claude Code CLI autorisé, bot Telegram, super-groupe avec sujets.

git clone https://github.com/devladpopov/teleclaude.git
cd teleclaude
bun install
cp .env.example .env
cp config/settings.example.json config/settings.json
bun run start

Dans settings.json, définissez allowedUsers, ttlMinutes (30 par défaut), maxConcurrent (5), claudePath.

Commandes du bot

| Commande | Description |

|----------|-------------|

| /help | Liste des commandes |

| /status | Processus actifs, état |

| /ttl N | Timeout inactif (1–1440 min) |

| /name <nom> | Renommer le sujet |

| /reset | Réinitialiser en préservant la mémoire |

| /kill | Arrêter le processus du sujet |

| /memory | Stats mémoire |

TeleClaude vs OpenClaw

| Aspect | TeleClaude | OpenClaw |

|--------|------------|----------|

| Hébergement | Auto-hébergé | Cloud |

| Backend | Claude Code CLI | API |

| Auth | Votre abonnement OAuth | Géré |

| Coût | Abonnement Claude seul | Frais supplémentaires |

| Mémoire | Basée sur fichiers, persistante | Intégrée |

Points forts

• Isolation complète des sujets sans changement de fenêtre.
• Auto-hébergé, sans frais au-delà de l'abonnement Claude.
• Compression auto et récupération de contexte.
• Support vocal via Whisper et réponses en streaming.
• Licence MIT, templates et paramètres personnalisables.

— Editorial Team