OpenClaw Telegram-Integration: Vom Bot erstellen bis zur fertigen Konfiguration

Sie möchten in Telegram direkt mit einem KI-Assistenten chatten – ohne Browser, Login und Wartezeit. Mit OpenClaw und einem Telegram Bot ist das in etwa einer halben Stunde möglich. Kein Backend-Wissen nötig, keine komplizierte Server-Konfiguration.

Dieser Artikel führt Schritt für Schritt von BotFather über Token, OpenClaw-Konfiguration und Whitelist-Sicherheit bis zum Test. Mit typischen Fallstricken und einer Checkliste zur Fehlerbehebung. In 30 Minuten zu einem KI-Assistenten, der rund um die Uhr erreichbar ist.

Günstiger Einstieg: ArkClaw macht KI-Agenten wirklich zugänglich

OpenClaw (der „Hummer“) ist beliebt, aber die Konfiguration schreckt ab? ByteDance Volcano Engine bietet mit ArkClaw eine Ein-Klick-Lösung: 24/7 online, Browser steuern, Skripte ausführen, Kalender verwalten – ohne Server- und Token-Gefrickel.

Der Preis ist der Hammer: 9,9 Yuan/Monat, mit Einladungscode ZLKUK54M (hier registrieren) nur 8,9 Yuan. Als Entwickler lohnt sich Coding Plan Pro – ArkClaw quasi gratis.

Vorbereitung: Grundlagen, die Sie kennen sollten

Bevor Sie loslegen, klären wir ein paar Begriffe. Kein trockener Theorieblock – wer das versteht, spart später viel Zeit.

Ein Telegram Bot ist kein normales Konto. Er ist eher eine Schnittstelle für automatische Antworten: Nachrichten empfangen und beantworten, aber nicht selbst Gespräche beginnen. Wie ein Support-Bot – er antwortet, wenn Sie fragen.

Wer ist BotFather? Der offizielle „Bot-Fabrik“-Dienst von Telegram. Jeder Bot entsteht hier. BotFather ist selbst ein Bot – Sie chatten mit ihm, um Ihren Bot anzulegen und zu konfigurieren. Am Anfang klang das für mich seltsam: Ein Bot, der Bots verwaltet.

Was macht OpenClaw? Kurz gesagt: die Brücke zwischen Telegram und großen Sprachmodellen. Telegram liefert die Nachricht, OpenClaw leitet sie an Claude oder GPT weiter und schickt die Antwort zurück. Sie schreiben keinen Code dafür.

Das brauchen Sie:

• Ein Telegram-Konto (haben die meisten)
• Installiertes und laufendes OpenClaw (sonst siehe offizielle Doku oder unsere Installationsanleitung in der Serie)
• API-Key eines KI-Modells (Claude, GPT, Gemini – auch Free-Tier zum Testen)

Ehrlich gesagt ist die Vorbereitung überschaubar. OpenClaw unterstützt mehrere Plattformen (Telegram, WhatsApp, WeChat Work usw.) und verschiedene Modelle – einmal eingerichtet, lässt sich das Modell leicht wechseln.

Schritt 1: Telegram Bot über BotFather erstellen

Jetzt geht es los. Telegram öffnen, @BotFather suchen – das offizielle Konto mit blauem Häkchen. Vorsicht vor Nachahmern.

Bot anlegen – der Dialog ist einfach:

1. /newbot an BotFather senden
2. Anzeigename wählen, z. B. „Mein KI-Assistent“
3. Benutzernamen setzen: muss mit bot enden und weltweit einzigartig sein. Mein erster Versuch AIAssistantBot war schon vergeben – nach drei Versuchen klappte es

Bei „Benutzername bereits vergeben“: Ziffern oder Initialen ergänzen, z. B. MyAwesomeAI2024Bot.

Den Bot Token holen – der wichtigste Schritt. Nach erfolgreicher Erstellung sendet BotFather eine lange Zeichenkette, etwa:

123456789:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

Der Token ist wie ein Hausschlüssel. Wer ihn hat, kann Ihren Bot nutzen. Token in öffentlichen GitHub-Repos haben schon API-Kontingente in wenigen Stunden verbraucht – Verluste im dreistelligen Bereich. Sofort in einen Passwortmanager oder verschlüsselte Notizen kopieren – nicht in Chats oder Cloud-Notizen im Klartext.

Optional, aber empfohlen:

• /setdescription – Kurzbeschreibung für Nutzer
• /setabouttext – „Über“-Text
• /setuserpic – Profilbild für einen professionelleren Eindruck

Eigene Telegram User-ID notieren! Für die Whitelist gleich gebraucht. @userinfobot suchen, /start senden – Sie erhalten eine numerische ID wie 123456789. Notieren.

Schritt 2: OpenClaw Telegram Channel konfigurieren

Mit dem Bot Token geht es an OpenClaw. Klingt technisch, ist im Kern: eine JSON-Datei bearbeiten.

Konfigurationsdatei finden. Stand 2026 liegt der Standard unter ~/.openclaw/, Hauptdatei openclaw.json. Feldnamen und Hierarchie für Telegram: offizielle Telegram-Channel-Dokumentation. Alte Pfade wie ~/.clawdbot/config/channels.json stammen vor der Umbenennung – bei Altinstallation zuerst migrieren (siehe Serienartikel). Bei Docker prüfen, ob OPENCLAW_HOME / ~/.openclaw korrekt gemountet ist.

🔥 Verschwende keine Monate für ungenutzte Produkte! Teste deine SaaS-Nutzenversprechen mit Adsterra bei kleinem Budget ➡️

Jetzt testen →Anzeige

Unten eine verständliche Skizze (Einzelnutzer, eigene ID explizit erlaubt, ohne Pairing-Unsicherheit). Tatsächliche Schlüssel und Defaults (z. B. DM oft pairing) folgen Doku und Wizard – veraltete Array-Strukturen nicht blind kopieren:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE",
      "dmPolicy": "allowlist",
      "allowFrom": [123456789]
    }
  }
}

Felder (Auszug, an Doku ausgerichtet):

• botToken: Token von BotFather – ohne Leerzeichen oder Zeilenumbrüche
• dmPolicy / allowFrom: Wer darf per DM schreiben; für Solo-Nutzung oft allowlist + eigene numerische ID. Bei Standard pairing: erstes DM erfordert openclaw pairing approve telegram <CODE> auf dem Gateway (siehe Doku)
• enabled: Channel ein- oder ausschalten

Datei bearbeiten

Linux oder Mac:

nano ~/.openclaw/openclaw.json

Mit Docker: im Container die gemountete Datei (Pfad hängt vom Compose-Mount ab):

docker exec -it openclaw sh
vi /root/.openclaw/openclaw.json

Oder direkt auf dem Host im Mount-Verzeichnis.

Typische Fehler:

• Striktes JSON: kein Komma nach dem letzten Eintrag
• Beim Einfügen des Tokens oft extra Anführungszeichen oder Leerzeichen
• allowFrom ist ein Array – auch bei einer ID als [123456789] (ID-Format siehe Doku)

Beim ersten Mal hatte ich ein überzähliges Komma – OpenClaw startete nicht, erst in den Logs fiel es auf. JSONLint o. Ä. hilft gegen solche Patzer.

Schritt 3: Whitelist – Ihren Bot absichern

Die Whitelist ist entscheidend. Leakt der Token, kann jeder Ihr KI-Kontingent verbrauchen. Bekanntes Beispiel: Claude-Kontingent eines Monats in drei Tagen aufgebraucht.

Warum Whitelist Pflicht ist:

• Fremde sollen Ihr KI-Budget nicht leeren (echtes Geld)
• Gespräche können Arbeitsinhalte enthalten
• Kosten kontrollieren – besonders bei teuren Modellen wie GPT-4

Zugriffsstrategie: Die User-ID von @userinfobot gehört unter channels.telegram.allowFrom (zusammen mit dmPolicy).

Einzelnutzer (nur Sie):

"dmPolicy": "allowlist",
"allowFrom": [123456789]

Mehrere Nutzer (Team):

"dmPolicy": "allowlist",
"allowFrom": [123456789, 987654321, 555555555]

Telegram-ID anderer Personen:

1. Person sucht @userinfobot (offiziell alternativ: erst Bot per DM, dann from.id in openclaw logs --follow – siehe Doku)
2. /start senden
3. Numerische ID an Sie weitergeben
4. In allowFrom eintragen

Für Teams: Liste mit ID und Name pflegen; bei Austritt entfernen – elementare Sicherheit.

Pairing-Modus

Standard-DM bei Telegram ist oft pairing: erstes DM braucht openclaw pairing approve telegram <CODE> auf dem Gateway. Wollen Sie nur über User-ID ohne Pairing: dmPolicy: "allowlist" und allowFrom setzen (Doku).

Schritt 4: OpenClaw starten und Verbindung testen

Konfiguration fertig – Zeit für den Test.

Gateway starten

Lokal (nach openclaw onboard --install-daemon ggf. zuerst openclaw gateway status):

openclaw gateway
# oder Systemdienst:
openclaw gateway start

Im Alltag reicht die Gateway-CLI; kein erfundenes npm start statt der offiziellen Befehle.

Docker:

docker compose up -d

Status prüfen

Logs prüfen, ob der Telegram Channel geladen wurde. Mit Docker:

docker compose logs openclaw -f

Erwartbar etwa:

KiloClaw - Managed OpenClaw für Unternehmen: AI-Agent-Orchestrierung und smartes Modell-Routing

Jetzt starten →Anzeige

[INFO] Loading Telegram channel: telegram-main
[INFO] Telegram bot connected successfully
[INFO] Listening for messages...

Bei Fehlern: Meldung notieren – unten steht die Checkliste.

Erster Test

1. Bot-Benutzernamen in Telegram suchen (endet auf bot)
2. Start tippen
3. Testnachricht senden, z. B. „Hallo“ oder „Hi there“
4. Nach wenigen Sekunden sollte die KI-Antwort kommen

Beim ersten erfolgreichen Reply war ich überrascht – selbst gebaut und es antwortet wirklich.

Keine Antwort? Nicht sofort neu installieren – Checkliste unten löst die meisten Fälle.

Checkliste: Häufige Probleme

Bot schweigt oder Config wirkt nicht? Schritt für Schritt:

Problem 1: Bot antwortet gar nicht

In dieser Reihenfolge prüfen:

• Läuft OpenClaw? docker ps oder ps aux | grep openclaw
• Token korrekt in ~/.openclaw/openclaw.json unter channels.telegram.botToken – keine Leerzeichen oder falschen Anführungszeichen
• Ihre ID in allowFrom (allowlist) oder Pairing abgeschlossen? ID per @userinfobot oder Log bestätigen
• JSON gültig? z. B. JSONLint
• KI-API-Key gültig und Guthaben vorhanden?

Debug:

# OpenClaw-Logs
docker compose logs openclaw -f

# JSON prüfen
cat ~/.openclaw/openclaw.json | jq .

Problem 2: „Unauthorized“ oder „Forbidden“

Meist Whitelist: unter dmPolicy: "allowlist" muss Ihre Telegram-ID in allowFrom stehen (Doku erlaubt auch Präfix-Strings). Bei pairing: openclaw pairing approve telegram <CODE> ausführen. Nach Änderungen neu starten.

Problem 3: Langsame Antworten

Mögliche Ursachen:

• Langsame KI-API (Stoßzeiten)
• Netzwerk zwischen Server und Anbieter
• Wenig CPU/RAM auf dem Server

Verbesserungen:

• Schnelleres Modell testen
• Statt GPT-4 z. B. GPT-3.5 oder Claude 3 Haiku
• Server oder Netzwerk optimieren

Problem 4: Konfiguration wirkt nicht

Klassiker: Neustart vergessen.

docker compose restart
# oder
systemctl restart openclaw

Problem 5: Gesprächsverlauf ansehen

OpenClaw speichert lokal:

• Log-Dateien (Standardpfad)
• Control UI (falls aktiv)
• Datenbank (SQLite o. Ä. je nach Config)

Problem 6: Bot Token geleakt

1. Bei BotFather /revoke
2. /token für neuen Token
3. OpenClaw-Config aktualisieren
4. Neustart
5. Nutzung beim KI-Anbieter prüfen

Erweiterte Konfiguration (optional)

Für den Alltag reicht die Basis – OpenClaw bietet mehr.

Willkommensnachricht und Befehlsmenü

In BotFather mit /setcommands, z. B.:

start - Gespräch beginnen
help - Hilfe anzeigen
clear - Verlauf leeren

Nutzer sehen die Liste bei /.

Alibaba Cloud - Top-Wahl für Entwickler, exklusiv 15 % Rabatt auf Lighthouse-Server

15 % Rabatt sichern →Anzeige

DM-Pairing aktivieren

Mehrere Nutzer ohne manuelle Whitelist – Pairing-Code:

"enableDmPairing": true

OpenClaw erzeugt einen Code; Nutzer geben ihn beim ersten Mal ein. Gut für Dienste für andere.

Unterschiedliche Modelle pro Nutzer

Admins GPT-4, andere GPT-3.5 – siehe OpenClaw-Doku, Abschnitt Multi-Model.

OpenClaw Skills

Skills ermöglichen echte Aktionen:

• Dateiverwaltung
• Shell-Befehle
• Websuche
• Code schreiben und debuggen

Shell-Ausführung besonders vorsichtig aktivieren – hohes Sicherheitsrisiko.

Gedächtnis und personalisierte Antworten

OpenClaw speichert Verläufe; Speicherlänge und System-Prompts anpassbar – Assistent passt sich Ihrem Stil an.

Details dazu in der offiziellen Dokumentation.

Fazit

Der Ablauf ist überschaubar: Bot bei BotFather, Token, OpenClaw, Whitelist, Test – in etwa 30 Minuten.

Typische Stolpersteine:

• Bot Token sicher aufbewahren, nicht ins Repo committen
• Whitelist nicht überspringen
• JSON exakt halten – ein Komma zu viel bricht den Start
• Nach Config-Änderungen neu starten

Wenn Sie dieser Anleitung gefolgt sind, sollten Sie jetzt einen funktionierenden Telegram-KI-Assistenten haben. Fragen stellen, ohne Browser und Login – deutlich angenehmer.

Als Nächstes:

• Verschiedene KI-Modelle ausprobieren
• Skills erkunden
• Teammitglieder einbinden

OpenClaw unterstützt auch WhatsApp, WeChat Work und mehr – das Telegram-Setup überträgt sich leicht.

Bei Problemen: Checkliste oben oder die Community. Genau das macht Spaß – jedes gelöste Problem bringt Neues.

Jetzt: Chatten Sie mit Ihrem Assistenten!