Telegram-Coding-Assistent in 45 Minuten einrichten – Schritt-für-Schritt

Eine Telegram-Gruppe und ein lokaler KI-Assistent sind alles, was Sie brauchen, um innerhalb weniger Minuten einen voll funktionsfähigen Coding-Agenten zu erstellen. Dieser Agent beantwortet Ihre Fragen direkt in der Chat-App und führt gleichzeitig Code in einem geteilten Terminal-Fenster aus. Die Einrichtung erfordert nur ein paar Skripte, grundlegende Systemkenntnisse und ein paar Minuten Geduld.

Warum dieser Ansatz funktioniert

Der Vorteil liegt in der direkten Integration: Ihr Coding-Agent läuft lokal auf Ihrem Rechner in einer tmux-Session, während Telegram als Schnittstelle dient. Das bedeutet:

• Keine Cloud-Server nötig – alles läuft auf Ihrer Maschine, was Datenschutz und Geschwindigkeit verbessert.
• Echtzeit-Befehle – Sie können den Agenten direkt steuern, ohne zwischen Fenstern zu wechseln.
• Einfache Fehlerbehebung – Da alles lokal läuft, lassen sich Probleme schneller identifizieren und beheben.

Der gesamte Prozess ist in zwei Phasen unterteilt: Zuerst die lokale Einrichtung, dann die Telegram-Integration. Beide Schritte sind durch vorgefertigte Skripte automatisierbar, benötigen aber ein paar manuelle Vorarbeiten.

Die wichtigsten Voraussetzungen vor dem Start

Bevor Sie mit der Einrichtung beginnen, sollten Sie sicherstellen, dass Ihr System folgende Komponenten unterstützt. Viele Fehler entstehen durch veraltete Abhängigkeiten oder falsche Konfigurationen – die meisten davon lassen sich vermeiden, wenn Sie die Anforderungen im Voraus prüfen.

Systemvoraussetzungen

• Ein eigenes Terminal mit `tmux` – Das Tool muss installiert sein, um den Coding-Agenten in einer stabilen Session zu betreiben.
• Ein funktionierender Coding-Agent – Dieser muss bereits lokal installiert und authentifiziert sein. Unterstützte Optionen sind opencode, Codex oder Claude Code.
• Ein festgelegtes `tmux`-Fenster – Notieren Sie sich die genaue Bezeichnung Ihres Ziel-Fensters, z. B. mein-rechner:1.1.
• Die Startanweisung Ihres Agenten – Die exakte Befehlszeile, mit der der Agent gestartet wird, inklusive aller benötigten Parameter.
• Die OpenClaw-Software – Diese fungiert als Brücke zwischen Telegram und Ihrem lokalen Agenten. Achten Sie darauf, die richtige Version zu verwenden.
• Ein Telegram-Konto – Sowohl die mobile App als auch ein Bot sind erforderlich.

Versionen und Abhängigkeiten

Die korrekten Versionen der verwendeten Tools sind entscheidend. Die folgende Matrix zeigt die getesteten Versionen, die Sie unbedingt einhalten sollten:

• Node.js 24.11.1 – OpenClaw ist auf diese Version ausgelegt. Neuere Hauptversionen können zu Build-Fehlern führen.
• pnpm 11.2.2 – Der Package-Manager muss exakt diese Version nutzen.
• OpenClaw (commit 2026.5.27) – Verwenden Sie einen festen Commit, um Konsistenz zu gewährleisten.
• Coding-Agent (z. B. opencode) – Stellen Sie sicher, dass dieser installiert und einsatzbereit ist.

Ein häufiger Fehler ist die Verwendung einer falschen Node.js-Version. Die meisten Probleme lassen sich vermeiden, indem Sie die Versionen exakt übernehmen.

Schnelle Einrichtung mit automatisierten Skripten

Für die meisten Nutzer ist der schnellste Weg die Verwendung der bereitgestellten Skripte. Diese automatisieren den Großteil der Einrichtung und reduzieren den manuellen Aufwand auf ein Minimum.

Skripte herunterladen und ausführen

Laden Sie zunächst die beiden Skripte von einem vertrauenswürdigen Gist herunter:

curl -fsSL " -o setup-openclaw.sh
curl -fsSL " -o ready-check.sh
chmod +x setup-openclaw.sh ready-check.sh

OpenClaw installieren und den Gateway starten

Führen Sie das Installationsskript aus und geben Sie dabei Ihren Bot-Token sowie den Kontonamen an:

OPENCLAW_BOT_TOKEN="IHR_BOT_TOKEN" OPENCLAW_BOT_ACCOUNT="mein-bot" ./setup-openclaw.sh

Dieses Skript übernimmt folgende Schritte:

• Die korrekte Node.js-Version installiert und aktiviert.
• Den OpenClaw-Quellcode klont und kompiliert.
• Den Gateway-Prozess in einer eigenen tmux-Session startet.

Telegram-Seite einrichten

Bevor Sie den Agenten testen können, müssen Sie in Telegram einige manuelle Schritte durchführen:

1. Erstellen Sie einen neuen Bot über @BotFather und notieren Sie den erhaltenen Token.
2. Richten Sie eine neue Gruppe ein und fügen Sie den Bot als Administrator hinzu.
3. Aktivieren Sie die Themenfunktion in der Gruppe, um eine strukturierte Diskussionsebene zu schaffen.
4. Erstellen Sie ein neues Thema, z. B. projekt-a, und senden Sie eine erste Nachricht darin.

Verbindung zwischen Telegram und dem lokalen Agenten herstellen

Fügen Sie Ihre Telegram-Benutzer-ID und die Themen-ID zur Allowlist in der OpenClaw-Konfiguration hinzu. Erstellen Sie dazu die Konfigurationsdatei:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "accounts": {
        "mein-bot": {
          "botToken": "IHR_BOT_TOKEN"
        }
      }
    }
  }
}

Speichern Sie die Datei unter ~/.openclaw/openclaw.json und überprüfen Sie die Syntax:

chmod 600 ~/.openclaw/openclaw.json
python3 -c "import json; json.load(open('$HOME/.openclaw/openclaw.json')); print('JSON OK')"

Starten Sie den Gateway-Prozess:

pnpm gateway:watch

Manuelle Einrichtung für fortgeschrittene Nutzer

Wer die Automatisierung vermeiden möchte, kann die Einrichtung auch manuell durchführen. Der Prozess besteht aus drei Hauptschritten: der Telegram-Konfiguration, der lokalen Einrichtung und der Verbindung beider Systeme.

Telegram-Gruppe und Bot einrichten

1. Erstellen Sie einen Bot über @BotFather und notieren Sie den Token.
2. Erstellen Sie eine neue Gruppe und fügen Sie den Bot als Administrator hinzu.
3. Aktivieren Sie die Themenfunktion und erstellen Sie ein neues Thema.
4. Senden Sie eine Testnachricht, um die Gruppe und das Thema zu registrieren.

Lokale Umgebung vorbereiten

Installieren Sie die benötigten Tools manuell:

nvm install 24.11.1 && nvm use 24.11.1
corepack enable && corepack prepare pnpm@11.2.2 --activate
git clone  ~/openclaw
d cd ~/openclaw
pnpm install
pnpm build

Starten Sie den Gateway-Prozess in einer tmux-Session:

pnpm gateway:watch

Verbindung testen

Sobald der Gateway läuft, können Sie die Verbindung mit dem ready-check.sh-Skript überprüfen:

AGENT_ID=mein-agent PANE=mein-rechner:1.1 ./ready-check.sh

Dieser Befehl sendet eine Testanfrage an Ihren lokalen Agenten und bestätigt, dass die Integration funktioniert.

Nächste Schritte nach der erfolgreichen Einrichtung

Sobald Ihr Coding-Agent auf Telegram reagiert, können Sie die Funktionalität erweitern. Zusätzliche Features wie Langzeitgedächtnis, Überwachungstools und erweiterte Befehle lassen sich schrittweise integrieren. Der Vorteil dieses Ansatzes ist, dass Sie mit einer soliden Basis starten und die Erweiterungen nach Bedarf hinzufügen können – ohne dass die Kernfunktionalität darunter leidet.