TeleClaude für Claude Code in Telegram

TeleClaude: Selbst gehosteter Telegram-Bot für isolierte Claude-Code-Sitzungen

Nach dem Shutdown von OpenClaw haben Entwickler den Zugriff auf Claude Code über Telegram verloren. TeleClaude behebt das: Eine TypeScript-App auf Bun, die lokale Claude-Code-CLI-Prozesse startet und Nachrichten aus Supergroup-Themen in isolierte Projektverzeichnisse leitet. Sie nutzt OAuth-Authentifizierung aus deinem eigenen Claude-Abo – keine Mittelsmänner.

Architektur und Routing

TeleClaude greift über Grammy in die Telegram Bot API ein. Jede Nachricht aus einem Supergroup-Thema startet einen dedizierten Claude-Code-Prozess mit eigenem Projektordner. Es unterstützt Sitzungskontinuität, Kontextkomprimierung und Speicher-Deduplizierung.

Telegram Bot API → Grammy Router → Process Manager → Claude Code CLI (pro Thema)

Wichtige Komponenten:

• Themenbasiertes Routing mit Kontextinjektion.
• Process Manager mit TTL, Parallelitätslimits und Aufräumung.
• Dateibasierter Speicher: SOUL.md (Persönlichkeit), main-memory.md (gemeinsame Wissensbasis), topic-memory.md (Projektgeschichte).

Speichersystem und Ebenen

Der Speicher ist in drei Ebenen strukturiert, um Kontext über Sitzungen hinweg zu erhalten:

project/
├── SOUL.md              # Kommunikationsstil, Regeln
├── main-memory.md       # Symlink zur gemeinsamen Wissensbasis
├── topic-memory.md      # Automatisch aktualisierte Projektgeschichte
└── memory/
    ├── people/
    ├── services/
    ├── shared/
    └── projects/

Claude Code aktualisiert topic-memory.md selbstständig. Bei Neustart oder Sitzungs-Reset lädt der Kontext aus den Dateien neu. Deduplizierung entfernt periodisch Duplikate über Dateien hinweg.

Projektautomatisierung und Komprimierung

Ein neues Thema in der Supergroup erstellt automatisch ein Verzeichnis aus templates/. Der Bot verlinkt SOUL.md, main-memory.md und initialisiert den Speicher. Die erste Nachricht startet Claude Code mit vollständigem Kontext.

Die Komprimierung greift bei Annäherung an Kontextlimits: Wichtige Fakten werden in den Speicher gespeichert, Sitzung wird zurückgesetzt. Mit /compact manuell auslösen.

TeleClaude-Features

• Themen-Routing: Isolierte Prozesse und Verzeichnisse.
• Persistenter Speicher: Drei Ebenen mit Querverweisen zwischen Projekten.
• Auto-Projekterstellung: Vorlagen für neue Themen.
• Sprachnachrichten: Optionale lokale Whisper-Transkription.
• Streaming: Schreibindikator und inkrementelle Updates.
• Modelle: Opus, Sonnet, Haiku oder lokal via Claude Code.
• Verwaltung: TTL, Limits, Prozessabbrüche.

Installation und Einrichtung

Voraussetzungen: Bun 1.0+, autorisierter Claude Code CLI, Telegram-Bot, Supergroup mit Themen.

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

In settings.json: allowedUsers, ttlMinutes (Standard 30), maxConcurrent (5), claudePath einstellen.

Bot-Befehle

| Befehl | Beschreibung |

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

| /help | Befehlsliste |

| /status | Aktive Prozesse, Status |

| /ttl N | Leerlauf-Timeout (1–1440 Min) |

| /name <name> | Thema umbenennen |

| /reset | Reset mit erhaltenem Speicher |

| /kill | Thema-Prozess stoppen |

| /memory | Speicher-Statistiken |

TeleClaude vs OpenClaw

| Aspekt | TeleClaude | OpenClaw |

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

| Hosting | Selbst gehostet | Cloud |

| Backend | Claude Code CLI | API |

| Auth | Dein OAuth-Abo | Verwaltet |

| Kosten | Nur Claude-Abo | Zusätzliche Gebühren |

| Speicher | Dateibasiert, persistent | Eingebaut |

Wichtige Highlights

• Volle Themenisolation ohne Fensterwechsel.
• Selbst gehostet, keine Kosten jenseits des Claude-Abos.
• Auto-Komprimierung und Kontext-Wiederherstellung.
• Sprachunterstützung via Whisper und Streaming-Antworten.
• MIT-Lizenz, anpassbare Vorlagen und Einstellungen.

— Editorial Team