michel.to

Claude Telegram Gateway: mein KI-System ist jetzt Open Source

11. Apr. 2026Open SourceBehind the Scenes

Wir haben heute den Claude Telegram Gateway als Open-Source-Projekt veröffentlicht — den Kern unseres KI-Systems Metis. Der Code, der seit Wochen unseren Always-On AI Assistenten antreibt, steht ab sofort auf GitHub zur Verfügung.

Was es ist

Der Claude Telegram Gateway ist ein Python-Daemon, der Telegram-Messages empfängt und für jede Konversation eine Claude Code CLI Session spawnt. Persistent Sessions, Voice-Nachrichten, zeitgesteuerte Trigger, File Handling — alles was man braucht um aus einer Claude Subscription einen vollwertigen Always-On AI Assistenten zu bauen.

Kein Framework, keine komplexe Infrastruktur. Ein einzelnes Python-File, systemd-ready, läuft auf jedem Linux-Server.

Der Trick: Keine Extra-Kosten

Claude Pro und Max Subscriptions inkludieren die Claude Code CLI — unbegrenzt. API-Calls über die Anthropic API kosten dagegen pro Token. Der Gateway routet alles über die CLI. Das bedeutet: volle Claude-Power, keine zusätzlichen Kosten über die Subscription hinaus.

Das ist kein Hack und kein Exploit. Die CLI ist offiziell im Abo enthalten. Wir nutzen sie einfach programmatisch statt interaktiv.

Features

  • Persistent Sessions — Jede Konversation hat eine eigene Session-ID. Claude erinnert sich an alles aus vorherigen Nachrichten.
  • Scheduled Triggers — Zeitgesteuerte Aufgaben via YAML-Konfiguration: Cron-Expressions, Intervalle oder One-Shot Timer.
  • Voice In + Out — Sprachnachrichten rein (via Whisper) und Antworten als Audio raus (via ElevenLabs).
  • File Handling — Dateien, Fotos, Dokumente senden und empfangen.
  • Budget Tracking — Übersicht über Token-Verbrauch und Session-Kosten.
  • Control API — HTTP-Endpunkt für programmatischen Zugriff und Monitoring.
  • Circuit Breaker — Automatischer Schutz vor Endlosschleifen und unkontrolliertem Ressourcenverbrauch.

Warum Open Source

Die Community hat OpenClaw verloren. Anthropics Policy-Änderung zu Third-Party-Harnesses hat das Projekt effektiv beendet — wir haben darüber geschrieben. Es gibt aktuell nichts Vergleichbares für Leute die einen persönlichen KI-Agenten auf Basis von Claude betreiben wollen.

Wir wollen diese Lücke füllen. Nicht mit einem überladenen Framework, sondern mit einem fokussierten Tool das genau eine Sache richtig macht: Claude über Telegram erreichbar machen — zuverlässig, persistent, rund um die Uhr.

Architektur

Die Architektur ist bewusst simpel gehalten:

Telegram → Gateway → claude -p --resume <session-id> → Response streamt zurück nach Telegram

Single-file Python. Kein Django, kein FastAPI, kein LangChain. Abhängigkeiten: python-telegram-bot, pyyaml, und die Claude CLI. Der Daemon läuft als systemd-Service, startet automatisch neu bei Crashes, und loggt sauber nach journald.

Sessions sind persistent über --resume. Das heißt Claude behält den gesamten Kontext einer Konversation — inklusive aller Tools die er im Dateisystem oder im Web nutzt. Genau wie wenn man direkt im Terminal arbeitet, nur eben von unterwegs über Telegram.

Projekt-Links

Quickstart

Loslegen in vier Schritten:

  1. git clone https://github.com/Kenny1338/claude-telegram-gateway.git
  2. .env konfigurieren — Telegram Bot Token, erlaubte User-IDs, optionale API-Keys für Voice
  3. pip install -r requirements.txt
  4. python gateway.py — fertig.

Für Production empfehlen wir den mitgelieferten systemd-Service. Aber zum Ausprobieren reicht ein Terminal und eine Claude Subscription.

Wir freuen uns auf Feedback, Issues und Pull Requests. Das Projekt lebt davon, dass Leute es nutzen und verbessern.

Hilfe gefällig?

Wenn es beim Nachmachen hakt: Ich komme vorbei. Erstgespräch kostenlos.

Anrufen Anfrage schreiben