OpenCode per Telegram steuern: Der Bot von grinev im Praxis-Check
Mobiler OpenCode-Client über Telegram: Führen Sie KI-Codierungsaufgaben von Ihrem Telefon aus aus und überwachen Sie sie, während alles lokal auf Ihrem Computer läuft. Unterstützung geplanter Aufgaben.
Auf einen Blick
- Was ist das?
- Der OpenCode Telegram Bot von grinev bringt die KI-Coding-CLI aufs Handy, ohne Ports zu öffnen. Wir zeigen, wie er funktioniert, was er kann und wo die Grenzen liegen.
- Für wen ist es gedacht?
- Wer OpenCode bereits nutzt und seine Agenten vom Handy aus starten, beobachten oder planen möchte, findet hier eine passende Lösung. Wer keinen Wert auf Telegram legt oder eine vollständige Web-Oberfläche braucht, sollte bei der CLI bleiben.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 2 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich TypeScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Ein Client, der keine Ports öffnet
Der OpenCode Telegram Bot löst ein konkretes Problem: OpenCode ist eine CLI, die auf deinem Rechner läuft. Wer unterwegs ist, hat keinen Zugriff darauf. Der Bot schafft eine Brücke zwischen Telegram und dem lokalen OpenCode-Server, ohne dass du dafür einen Port nach außen öffnest. Die Kommunikation läuft nur zwischen deinem Rechner und der Telegram Bot API. Das ist ein klarer Sicherheitsvorteil gegenüber einer eigenen Web-API. Der Bot richtet sich an Entwickler, die OpenCode bereits nutzen und ihre Tasks auch vom Smartphone aus starten oder überwachen wollen. Die README nennt explizit die Unterstützung für macOS, Windows und Linux.
So funktioniert die Architektur
Die Architektur ist simpel: Der Bot läuft als Node.js-Prozess auf demselben Rechner wie der OpenCode-Server. Er verbindet sich standardmäßig mit `http://localhost:4096`, der lokalen OpenCode API. Von dort holt er den Status, sendet Prompts und empfängt Antworten. Die Telegram Bot API dient als reines Transportmedium. Der Bot kann Sessions erstellen, bestehende fortsetzen und sogar Live-Sessions verfolgen. Das bedeutet, du siehst in Telegram, was in einer laufenden CLI-Sitzung passiert. Die README spricht von einer „pinned message“ mit aktuellem Projekt, Worktree, Modell und Kontextnutzung. Dazu kommen Subagent-Aktivitäten, die live im Chat angezeigt werden. Das ist mehr als eine einfache Fernsteuerung, es ist eine Art zweite Oberfläche für OpenCode.
Einrichtung in drei Schritten
Die Installation ist bewusst niedrigschwellig gehalten. Zuerst erstellst du einen Bot bei @BotFather und holst dir deine Telegram User ID über @userinfobot. Dann startest du den OpenCode-Server mit `opencode serve`. Den Bot selbst installierst du entweder global mit `npm install -g @grinev/opencode-telegram-bot` und startest ihn mit `opencode-telegram start`, oder du nutzt `npx @grinev/opencode-telegram-bot@latest` direkt. Beim ersten Start führt dich ein interaktiver Assistent durch die Konfiguration. Er fragt nach Sprache, Bot-Token, User ID, OpenCode API URL und optionalen Server-Credentials. Alternativ kannst du alles über Umgebungsvariablen oder eine `.env`-Datei setzen. Wer den Bot im Hintergrund laufen lassen will, nutzt `--daemon` und verwaltet ihn mit `status` und `stop`. Für systemd oder Docker ist der Vordergrundmodus empfohlen.
Was der Bot alles kann
Die Funktionsliste ist lang und geht über einfaches Prompt-Senden hinaus. Du kannst Modelle wechseln, zwischen Plan- und Build-Modus umschalten, Custom Commands wie `init` oder `review` aus einem Inline-Menü starten und den Skills Catalog durchstöbern. Interaktive Fragen des Agents beantwortest du direkt per Inline-Buttons. Auch Dateianhänge sind möglich: Bilder, PDFs und Textdateien, sogar mehrere in einem Album. Voice-Prompts werden über eine Whisper-kompatible API transkribiert. Besonders interessant ist die Unterstützung für geplante Tasks. Du kannst Prompts für später oder in regelmäßigen Abständen einplanen. Die README nennt das eine „leichte OpenClaw-Alternative“. Dazu kommen Worktree-Wechsel, ein Dateibrowser mit `/ls` und eine Nachrichten-Warteschlange, die du in den Einstellungen aktivieren kannst.
Sicherheit und Einschränkungen
Die Sicherheit hängt an einem strikten Whitelist-Mechanismus: Nur deine Telegram User ID kann den Bot nutzen. Das ist gut, aber es bedeutet auch, dass du diese ID korrekt ermitteln musst. Ein Tippfehler und der Bot ist unzugänglich. Der Bot selbst öffnet keine Ports, aber er setzt voraus, dass der OpenCode-Server lokal läuft. Wer OpenCode auf einem anderen Rechner betreibt, muss die API-URL anpassen. Die README erwähnt optionale Server-Credentials, aber es bleibt unklar, ob diese verschlüsselt übertragen werden. Ein echtes Manko: Der Bot ist nur so aktuell wie die OpenCode-Version, die er anspricht. Änderungen an der API können zu Inkompatibilitäten führen. Die README weist selbst darauf hin, dass der `main`-Branch möglicherweise unveröffentlichte Änderungen enthält. Das bedeutet, die neuesten Features sind nicht immer in der npm-Version.
Alternativen und Abgrenzung
Der Bot positioniert sich als „leichtgewichtige OpenClaw-Alternative“. OpenClaw ist ein separates Projekt, das ebenfalls Agenten über Chat-Schnittstellen steuert, aber einen eigenen Server und eigene Agenten mitbringt. Der OpenCode Telegram Bot ist dagegen nur ein Client für OpenCode. Er ersetzt nicht die CLI, er ergänzt sie. Wer OpenClaw nutzt, bekommt mit diesem Bot keine vollständige Agenten-Plattform, sondern eine Fernbedienung für eine bestehende Installation. Eine andere Alternative wäre eine Web-Oberfläche wie OpenCode Web, aber die setzt in der Regel einen öffentlich erreichbaren Server voraus. Der Bot umgeht dieses Problem durch die Telegram-Integration. Das ist ein klarer Vorteil für alle, die Telegram ohnehin nutzen. Wer Telegram nicht nutzt, wird mit diesem Bot nichts anfangen können.
Wartung, Lizenz und Betrieb
Der Bot ist unter der MIT-Lizenz veröffentlicht, was bedeutet, dass du ihn frei nutzen und modifizieren kannst. Die Wartung scheint aktiv zu sein, die letzten Releases liegen im August 2026, die Versionsnummern steigen regelmäßig. Für den Betrieb brauchst du einen Prozess, der den Bot am Leben hält. Die README empfiehlt für systemd oder Docker den Vordergrundmodus, der Daemon-Modus ist nur für Standalone-Installationen gedacht. Das ist ein wichtiger Hinweis, denn ein Bot, der nicht läuft, bringt dir nichts. Du musst also einen systemd-Service oder ein Docker-Container einrichten, wenn du den Bot dauerhaft nutzen willst. Die Dokumentation verweist auf eine eigene Datei für Linux-systemd-Setup, die aber in der README nicht weiter ausgeführt wird. Das ist ein Punkt, den man vor der Adoption prüfen sollte.
Redaktionelles Fazit
Wer OpenCode bereits nutzt und seine Agenten vom Handy aus starten, beobachten oder planen möchte, findet hier eine passende Lösung. Wer keinen Wert auf Telegram legt oder eine vollständige Web-Oberfläche braucht, sollte bei der CLI bleiben. Vor der Nutzung sollte man die eigene Telegram User ID verifizieren, den Bot auf einen privaten Kanal beschränken und testen, ob die OpenCode-Version mit der Bot-Version kompatibel ist. Der Bot ist kein Ersatz für OpenCode, sondern eine Fernbedienung, die auf einem lokalen Server aufsetzt.
Community-Notizen