ACLClouds
ACLClouds

Tutorial: einen Telegram-Bot erstellen und kostenlos hosten

Einen Telegram-Bot mit BotFather erstellen, den minimalen Code in Python oder Node.js schreiben und ihn dann kostenlos rund um die Uhr hosten: jeder

Um einen Telegram-Bot kostenlos zu hosten, brauchen Sie drei Dinge: einen Token von BotFather, etwa zehn Zeilen Code in Python oder Node.js und eine Maschine, die an Ihrer Stelle eingeschaltet bleibt. Dieses Tutorial geht diese drei Schritte der Reihe nach durch, bis zur ersten Antwort des Bots auf den Befehl /start. Es nutzt Polling: Der Bot braucht weder eine öffentliche Adresse noch ein HTTPS-Zertifikat.

  • BotFather erstellt den Bot und gibt seinen Token mit dem Befehl /newbot aus.
  • Der Code liest den Token aus der Umgebungsvariable TELEGRAM_TOKEN, nie fest in einer Datei eingetragen.
  • Im Polling braucht der Bot weder eine öffentliche Adresse noch ein HTTPS-Zertifikat.
  • Der Free-Tarif von ACLClouds lässt 1 Node.js- oder Python-Bot mit 315 MB RAM laufen, ohne Kreditkarte.
  • Ein Fehler 409 Conflict bedeutet, dass zwei Kopien des Bots mit demselben Token laufen.

Den Bot mit BotFather erstellen

Öffnen Sie in Telegram einen Chat mit @BotFather, dem offiziellen Konto, das die Bots verwaltet, und senden Sie /newbot. Er fragt nach einem Anzeigenamen und dann nach einem Benutzernamen, der auf bot enden muss, zum Beispiel mon_premier_bot. Er antwortet mit dem Token, einer Folge von Ziffern und Buchstaben, die durch einen Doppelpunkt getrennt sind.

  • Der Token gibt die vollständige Kontrolle über den Bot: Schreiben Sie ihn weder in den Code noch in einen Screenshot.
  • Wenn er durchgesickert ist, senden Sie /revoke an BotFather: Der alte Token funktioniert nicht mehr und ein neuer wird erstellt.
  • In einer Gruppe erhält ein Bot standardmäßig nur die Befehle. Um alle Nachrichten zu lesen, deaktivieren Sie den Privatsphäre-Modus mit /setprivacy.

Der minimale Code in Python

Die meistgenutzte Bibliothek ist python-telegram-bot. Erstellen Sie eine Datei requirements.txt, die die Zeile python-telegram-bot enthält, und dann eine Datei bot.py. Das Programm liest den Token aus der Umgebungsvariable TELEGRAM_TOKEN, deklariert einen Befehl /start und startet den Empfang der Nachrichten.

  • Erstellen Sie die Anwendung: Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build().
  • Schreiben Sie eine asynchrone Funktion start(update, context), die mit await update.message.reply_text("Hallo") antwortet.
  • Verknüpfen Sie sie mit dem Befehl über add_handler(CommandHandler("start", start)) und schließen Sie mit run_polling() ab.
  • Das zu installierende Paket heißt python-telegram-bot, während der Import from telegram.ext import Application, CommandHandler lautet.

Derselbe Bot in Node.js

In Node.js erledigen Telegraf und grammY dieselbe Arbeit. Mit Telegraf enthält die package.json die Abhängigkeit telegraf und ein start-Skript, das node index.js ausführt. Die Datei index.js besteht aus vier Zeilen.

  • Laden Sie die Bibliothek: const { Telegraf } = require("telegraf").
  • Erstellen Sie den Bot mit dem aus der Umgebung gelesenen Token: const bot = new Telegraf(process.env.TELEGRAM_TOKEN).
  • Antworten Sie auf /start mit bot.start((ctx) => ctx.reply("Hallo")) und starten Sie dann bot.launch().

Den Bot kostenlos hosten

Der Free-Tarif des Bot-Hostings von ACLClouds lässt ein Node.js- oder Python-Programm dauerhaft laufen, ohne Kreditkarte. Er wird für Discord vorgestellt, aber ein Telegram-Bot im Polling funktioniert dort genauso: Es ist ein Programm, das eine ausgehende Verbindung öffnet. Wählen Sie bei der Bestellung Python oder Node.js und ersetzen Sie dann das Beispielprojekt durch Ihre Dateien, über den Reiter Dateien oder per SFTP auf Port 2222.

  • Fügen Sie im Reiter Start eine Umgebungsvariable namens TELEGRAM_TOKEN mit dem Token von BotFather hinzu. Das Feld „Discord-Bot-Token“ bleibt leer.
  • Laden Sie weder node_modules noch .venv hoch: Die Abhängigkeiten werden auf dem Server anhand von requirements.txt oder package.json installiert.
  • Für das Hochladen der Dateien mit FileZilla folgen Sie der Anleitung einen Bot per SFTP bereitstellen.

Starten und testen

Starten Sie den Bot über die Konsole, öffnen Sie dann in Telegram den Chat mit Ihrem Bot und senden Sie /start. Die Antwort kommt in ein bis zwei Sekunden. Wenn nichts kommt, zeigt die Konsole die Ursache: Lesen Sie die erste Fehlerzeile.

  • 401 Unauthorized: Der Token ist falsch oder wurde widerrufen. Kopieren Sie ihn erneut von BotFather.
  • 409 Conflict: Eine andere Kopie des Bots läuft bereits mit demselben Token, oft auf Ihrem Computer. Stoppen Sie sie. Falls irgendwann ein Webhook gesetzt wurde, löschen Sie ihn mit der Methode deleteWebhook.
  • No module named telegram: Die Zeile python-telegram-bot fehlt in requirements.txt. Siehe die Anleitung ModuleNotFoundError.
  • Keine Nachricht in einer Gruppe empfangen: Der Privatsphäre-Modus ist aktiv, nur die Befehle kommen an.

Was der Free-Tarif ermöglicht

Ein Telegram-Befehlsbot verbraucht wenig: Der Free-Tarif reicht ihm in den meisten Fällen. Seine Grenzen sind öffentlich, und die Gegenleistung für das kostenlose Angebot ist eine Verlängerung von Hand.

  • 1 Bot pro Konto, 315 MB RAM, 0,25 vCPU und 715 MB Speicher.
  • Kostenlose Verlängerung alle 4 Tage auf der Seite des Bots. Ohne Verlängerung wird der Bot ausgesetzt.
  • Der Bot wird zwischen zwei Nachrichten nicht in den Ruhezustand versetzt und startet nach einem unerwarteten Stopp von selbst neu.
  • Polling oder Webhook, Senderate und Arbeitsspeicher: Die Anleitung Telegram-Bot 24/7 erläutert diese Entscheidungen.

Häufig gestellte Fragen

Kann ein Telegram-Bot auf einem Tarif laufen, der für Discord gedacht ist?

Ja. Der Tarif führt ein Node.js- oder Python-Programm aus: Ein Telegram-Bot im Polling startet dort wie ein Discord-Bot. Nur der Name der Token-Variable ändert sich.

Brauche ich einen Domainnamen oder ein HTTPS-Zertifikat?

Nein, nicht im Polling: Der Bot fragt Telegram ab. Ein Webhook dagegen braucht eine HTTPS-Adresse, die aus dem Internet erreichbar ist.

Antwortet der Bot, wenn mein Computer ausgeschaltet ist?

Ja. Er läuft auf der Infrastruktur von ACLClouds. Sie müssen nur den Free-Tarif alle 4 Tage kostenlos auf der Seite des Bots verlängern.

Welche Bibliothek sollte ich für den Einstieg wählen?

python-telegram-bot in Python, Telegraf oder grammY in Node.js. Alle drei sind dokumentiert und reichen für einen Befehlsbot. Nehmen Sie die Sprache, die Sie schon kennen.