Wie Sie Ihren KI-Agenten mit Telegram verbinden (vollständige Einrichtungsanleitung)

Warum Telegram?

Telegram ist der empfohlene Kanal für Ihren OpenClaw-Agenten aus mehreren Gründen. Es verfügt über eine ausgereifte, gut dokumentierte Bot-API, funktioniert auf jeder Plattform (iOS, Android, Desktop, Web), unterstützt Nachrichtenformatierung, Dateifreigabe und Inline-Tastaturen, und die Bot-Erstellung ist völlig kostenlos ohne Genehmigungsprozess.

Am wichtigsten: Telegram-Nachrichten zwischen Ihnen und Ihrem Bot sind privat. OpenClaw kommuniziert mit Telegrams Servern, um Ihre Nachrichten zuzustellen, aber das KI-Modell verarbeitet nur, was Sie senden — Ihr Gesprächsverlauf bleibt auf Ihrem VPS.

Schritt 1: Ihren Telegram-Bot erstellen

Öffnen Sie Telegram und suchen Sie nach @BotFather — Telegrams offizieller Bot-Erstellungsservice. Starten Sie eine Unterhaltung und senden Sie:

/newbot

BotFather fragt nach:

1. Einem Namen für Ihren Bot — das ist der Anzeigename (z. B. "Mein KI-Assistent")
2. Einem Benutzernamen — muss auf "bot" enden (z. B. "meinassistent_bot")

Nach Bestätigung beider Angaben sendet BotFather Ihnen einen Bot-Token — eine lange Zeichenkette wie 1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ. Kopieren Sie diese sofort und bewahren Sie sie auf.

Schritt 2: Bot-Datenschutz konfigurieren

Standardmäßig empfangen Bots in Gruppen alle Nachrichten. Für einen persönlichen Agenten empfiehlt es sich, ihn fokussiert zu halten. In BotFather:

/setprivacy

Wählen Sie Ihren Bot und wählen Sie Enable. Das bedeutet, Ihr Bot empfängt nur an ihn gerichtete Nachrichten (die mit / beginnen oder ihn erwähnen). Für den persönlichen Einsatz in Direktnachrichten hat diese Einstellung keinen Effekt, aber es ist gute Praxis.

Erwägen Sie auch, eine Beschreibung und ein Profilbild zu setzen:

/setdescription
/setuserpic

Schritt 3: Ihre Telegram-Benutzer-ID ermitteln

OpenClaw muss wissen, welches Telegram-Konto berechtigt ist, mit Ihrem Agenten zu interagieren — Sie wollen nicht, dass jeder Ihrer persönlichen KI Nachrichten senden kann. Um Ihre Benutzer-ID zu erhalten, öffnen Sie einen Chat mit @userinfobot und senden Sie /start. Es antwortet mit Ihrer numerischen Benutzer-ID.

Notieren Sie diese. Bei der k-claw-Installation geben Sie diese ID als autorisierten Benutzer an.

Schritt 4: OpenClaw über k-claw installieren

Mit Ihrem Bot-Token und Ihrer Benutzer-ID bereit, starten Sie den k-claw-Installer auf Ihrem VPS:

curl -fsSL https://claw.krokanti.com/install | bash

Wenn der Installer nach Ihrem Messaging-Kanal fragt, wählen Sie Telegram. Er fragt nach:

• Ihrem Bot-Token (von BotFather)
• Ihrer Telegram-Benutzer-ID (von @userinfobot)
• Ihrem KI-API-Schlüssel
• Dem KI-Modell, das Sie verwenden möchten

Der Installer konfiguriert OpenClaw, richtet den systemd-Dienst ein und startet Ihren Agenten automatisch.

Schritt 5: Mit dem Chatten beginnen

Öffnen Sie Telegram und suchen Sie nach Ihrem Bot über seinen Benutzernamen. Senden Sie /start, um ihn zu initialisieren, dann fragen Sie beliebige Dinge:

Was ist die Hauptstadt von Australien?
Fasse die wichtigsten Punkte aus der letzten E-Mail zusammen, die ich dir geschickt habe.
Erinnere mich morgen um 9 Uhr daran, den Projektvorschlag zu überprüfen.

Ihr Agent antwortet direkt im Chat, das KI-Modell verarbeitet jede Nachricht über API, und der Gesprächsverlauf wird privat auf Ihrem VPS gespeichert.

Nützliche Bot-Befehle

OpenClaw enthält mehrere integrierte Befehle, die Sie in BotFather für eine bessere Nutzererfahrung einrichten können:

/setcommands

Dann einfügen:

start - Agent initialisieren
help - Verfügbare Befehle anzeigen
memory - Anzeigen, woran sich der Agent erinnert
clear - Gesprächskontext löschen
status - Agentenstatus prüfen

Fehlerbehebung

Häufige Probleme nach der Einrichtung:

• Bot antwortet nicht: Überprüfen Sie den systemd-Dienst — systemctl status kclaw-agent. Suchen Sie mit journalctl -u kclaw-agent -n 50 nach Fehlern in den Logs.
• Fehler "Ungültiger Token": Stellen Sie sicher, dass Sie den vollständigen Token von BotFather ohne zusätzliche Leerzeichen kopiert haben.
• Fehler "Nicht autorisierter Benutzer": Überprüfen Sie, ob Ihre Telegram-Benutzer-ID mit der bei der Installation angegebenen übereinstimmt. IDs sind nur numerisch.
• API-Ratenlimits: Wenn Sie viele Nachrichten schnell senden, kann die KI-API Anfragen limitieren. OpenClaw behandelt Wiederholungsversuche automatisch, aber die Antwortzeiten können vorübergehend langsamer werden.

Das k-claw-Dashboard zeigt Ihren Installationsstatus und Logs in Echtzeit an, was es einfach macht, Probleme zu diagnostizieren, ohne sich per SSH in Ihren Server einzuloggen.