So hostest du einen Telegram-Bot 24/7

Einführung

Um einen Telegram-Bot auf Square Cloud zu entwickeln und zu hosten, ist es wichtig, einer strukturierten Abfolge von Konfigurationen und Voraussetzungen zu folgen. Dieser technische Leitfaden deckt den gesamten Prozess ab, von der anfänglichen Einrichtung bis zum Produktions-Deployment.

Voraussetzungen

Square Cloud Konto: Registriere dich über die Registrierungsseite mit deiner E-Mail-Adresse.
Aktiver Plan: Stellt dedizierte Ressourcen und optimierte Leistung für deine Anwendung sicher. Sieh dir unsere verfügbaren Pläne an und wähle den passendsten für deine Bedürfnisse.

Diese Anleitung nutzt die Node.js-Runtime oder die Python-Runtime.

Projekt erstellen

Ein Telegram-Konto ist unerlässlich, um deinen Bot zu testen und mit ihm zu interagieren. Falls du noch keins hast, besuche die offizielle Telegram-Website, um dein Konto zu erstellen.

Bot-Anwendung auf Telegram

BotFather finden

Rufe Telegram Web auf und suche nach dem offiziellen BotFather-Bot, der für das Erstellen und Verwalten von Bots auf der Plattform zuständig ist.

Token erhalten

Starte eine Konversation mit BotFather und gib /start ein. Wähle dann die Option /newbot, um einen neuen Bot zu erstellen. Das System fragt nach einem Namen für deinen Bot und generiert nach der Bestätigung automatisch den notwendigen Authentifizierungs-Token.

Generieren des Telegram-Bot-Tokens mit BotFather

Halte deinen Token geheim: Dieser Token gewährt vollständige Kontrolle über den Bot. Schreibe ihn niemals in deinen Code und lege ihn nicht in deine ZIP-Datei: Die folgenden Beispiele lesen ihn aus der Umgebungsvariable TELEGRAM_BOT_TOKEN.

Bot entwickeln

Schreibe den Bot mit grammY (Node.js) oder pyTelegramBotAPI (Python). Beide Beispiele wiederholen jede Textnachricht:

Node.js - grammY
Python - telebot

Stelle sicher, dass Node.js auf deinem System installiert ist. Andernfalls lade es von der offiziellen Node.js-Website herunter.
Initialisiere ein neues Node.js-Projekt:

Terminal

npm init -y

Installiere die grammY-Bibliothek:

Terminal

npm install grammy

Erstelle die Hauptdatei (index.js) mit der folgenden Struktur:

index.js

const { Bot } = require("grammy");

// The token comes from the TELEGRAM_BOT_TOKEN environment variable
const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Reply to every text message with an echo
bot.on("message:text", async (ctx) => {
  await ctx.reply(`${ctx.me.username} responds: ${ctx.message.text}`);
});

// Long polling: the bot asks Telegram for new messages, so no public URL is needed
bot.start({
  onStart: (botInfo) => console.log(`Bot ${botInfo.username} started successfully!`),
});

Stelle sicher, dass Python und pip installiert sind. Andernfalls lade sie von der offiziellen Python-Website herunter.
Installiere die pyTelegramBotAPI-Bibliothek:

Terminal

pip install pyTelegramBotAPI

Erstelle die Hauptdatei (main.py):

main.py

import os

import telebot

# The token comes from the TELEGRAM_BOT_TOKEN environment variable
bot = telebot.TeleBot(os.environ["TELEGRAM_BOT_TOKEN"])
bot_name = bot.get_me().username


# Echo every message that isn't a command
@bot.message_handler(func=lambda message: not message.text.startswith("/"))
def echo_handler(message):
    bot.reply_to(message, f"{bot_name} responds: {message.text}")


if __name__ == "__main__":
    print(f"Bot {bot_name} started successfully!")
    # Long polling: no public URL is needed
    bot.infinity_polling()

Erstelle die requirements.txt-Datei, um die Abhängigkeiten zu verwalten:

requirements.txt

pyTelegramBotAPI

Square Cloud konfigurieren

Erstelle im Stammverzeichnis deines Projekts, neben deiner Hauptdatei, eine Datei squarecloud.app. Sie teilt Square Cloud mit, wie dein Bot ausgeführt wird:

DISPLAY_NAME=My Telegram Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Telegram Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

MAIN ist die Datei, die Square Cloud ausführt, und MEMORY ist der RAM des Bots in MB. Bots brauchen mindestens 256 MB; mit 512 MB hast du Luft zum Wachsen.
AUTORESTART=true startet den Bot nach einem Absturz neu. Lies dazu, wie der automatische Neustart funktioniert.
Es gibt keine SUBDOMAIN: Mit Long Polling braucht der Bot keine öffentliche URL.

Alle Felder findest du in der Referenz zur Konfigurationsdatei.

Bot-Token festlegen

Dein Code liest den Token aus der Umgebungsvariable TELEGRAM_BOT_TOKEN, daher landet der Token nie in deinen Dateien. Lege ihn auf eine dieser Arten fest:

Dashboard: Öffne auf der Upload-Seite Erweiterte Konfiguration und füge eine Variable namens TELEGRAM_BOT_TOKEN mit deinem Token als Wert hinzu. Bei einem bereits deployten Bot fügst du sie auf der Seite Umgebungsvariablen der Anwendung hinzu und startest den Bot neu.
CLI: Lege sie direkt nach dem Upload des Bots (siehe Deployen und prüfen) mit squarecloud app env set fest und starte den Bot neu:

squarecloud app env set TELEGRAM_BOT_TOKEN=your_token_here
squarecloud app restart

Der Bot liest seine Umgebungsvariablen beim Start, starte ihn deshalb nach jeder Änderung neu. Weitere Möglichkeiten, sie zu verwalten, findest du unter Umgebungsvariablen.

Um den Bot zuerst auf deinem Computer auszuführen, setze die Variable in deinem Terminal: export TELEGRAM_BOT_TOKEN=your_token_here unter macOS und Linux oder $env:TELEGRAM_BOT_TOKEN="your_token_here" in PowerShell.

Was in die ZIP-Datei gehört

Deine Hauptdatei (index.js oder main.py) und deine anderen Quelldateien.
package.json oder requirements.txt.
squarecloud.app.

Lass node_modules, .venv und __pycache__ weg: Square Cloud installiert deine Abhängigkeiten, wenn der Bot startet.

Deployen und prüfen

Erstelle die oben beschriebene ZIP-Datei und lade sie dann hoch:

Über das Dashboard

Upload-Seite aufrufen

Rufe die Upload-Seite auf und lade die ZIP-Datei deines Projekts hoch.

Umgebung konfigurieren

Nachdem du deine ZIP-Datei hochgeladen hast, musst du den Namen, die Hauptdatei oder Runtime-Umgebung und weitere Einstellungen für dein Projekt konfigurieren.
Wenn du ein Web-Projekt hochlädst, achte darauf, “Web Publication” auszuwählen und deinem Projekt eine Subdomain zuzuweisen.

Projekt bereitstellen

Klicke abschließend auf die Schaltfläche “Deploy”, um dein Projekt auf Square Cloud zu hosten.
Nach dem Deploy kannst du den Status und die Logs deines Projekts über das Dashboard überwachen.

Anwendung wird auf Square Cloud hochgeladen

Bestätige, dass deine App live ist

Dein erstes Deploy dauert in der Regel weniger als eine Minute. Warte im Dashboard, bis der Status deiner Anwendung als “running” angezeigt wird, und prüfe die Logs auf Startfehler.
Wenn du eine Website oder API bereitgestellt hast, öffne https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.

App startet nicht? Im Leitfaden zur Fehlerbehebung findest du die häufigsten Ursachen und Lösungen.

Über die CLI

Um diese Methode zu nutzen, braucht dein Projekt eine Konfigurationsdatei mit dem Namen squarecloud.app im Stammverzeichnis. Sie teilt Square Cloud mit, wie deine Anwendung ausgeführt wird.

Leitfaden zur Konfigurationsdatei

Erfahre, wie du die Konfigurationsdatei squarecloud.app erstellst, die die Umgebung deiner Anwendung definiert.

CLI installieren

Installiere die Square Cloud CLI. Falls du sie bereits hast, führe denselben Befehl aus, um sie zu aktualisieren:

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

Anmelden

Führe den folgenden Befehl aus. Er öffnet deinen Browser: Bestätige dort die Anmeldung, und die CLI ist einsatzbereit. Es gibt keinen API-Schlüssel zu kopieren. Für Skripte und CI siehe CLI-Authentifizierung.

squarecloud auth login

Projekt hochladen

Führe in deinem Projektordner den folgenden Befehl aus. Die CLI packt den aktuellen Ordner als ZIP, lässt dabei weg, was in der squarecloud.ignore steht, und lädt ihn hoch:

squarecloud upload

Um eine selbst erstellte ZIP-Datei hochzuladen, übergib sie mit --file:

squarecloud upload --file <path/to/zip>

Bestätige, dass deine App live ist

Dein erstes Deploy dauert in der Regel weniger als eine Minute. Prüfe den Status und die Logs deiner Anwendung direkt im Terminal:

squarecloud app status
squarecloud app logs

Wenn du eine Website oder API bereitgestellt hast, öffne https://<deine-subdomain>.squareweb.app in deinem Browser: du solltest sehen, dass deine Anwendung reagiert. Wenn du einen Bot bereitgestellt hast, sende ihm einen Befehl, um zu bestätigen, dass er online ist.

App startet nicht? Im Leitfaden zur Fehlerbehebung findest du die häufigsten Ursachen und Lösungen.

Bot testen

Suche deinen Bot nach dem Deploy auf Telegram und sende ihm eine Nachricht. Der Bot antwortet mit demselben Text, was bestätigt, dass er läuft.

Testen des Telegram-Bots nach dem Deployment

Häufige Fehler

Error 409: Conflict: terminated by other getUpdates request

Eine andere Kopie des Bots liest Updates mit demselben Token, zum Beispiel die, die du auf deinem Computer gestartet hast. Telegram liefert Updates pro Bot nur an eine Long-Polling-Verbindung. Stoppe die andere Kopie oder widerrufe den Token im BotFather, wenn du nicht weißt, wo sie läuft, lege dann den neuen Token fest und starte den Bot neu.

Error 401: Unauthorized

Der Token ist falsch oder wurde widerrufen. Kopiere den aktuellen Token aus dem BotFather, lege ihn erneut fest und starte den Bot neu.

Leerer Token oder `KeyError: 'TELEGRAM_BOT_TOKEN'`

Die Variable TELEGRAM_BOT_TOKEN ist nicht gesetzt: grammY bricht mit Empty token! ab und das Python-Beispiel mit einem KeyError. Lege die Variable fest, wie unter Bot-Token festlegen beschrieben, und starte den Bot neu.

Nächste Schritte

App startet nicht

Behebe fehlende Module, Speicherfehler und andere Startprobleme.

Umgebungsvariablen

Verwalte den Token deines Bots und andere Secrets.

python-telegram-bot mit aiohttp

Du nutzt python-telegram-bot? Behebe häufige NetworkError-Ausnahmen.

Mehr über diese Bibliotheken findest du in der offiziellen grammY-Dokumentation und auf der pyTelegramBotAPI-Seite auf PyPI.

Kontaktiere uns

Falls du weiterhin technische Schwierigkeiten hast, steht dir unser spezialisiertes Support-Team zur Verfügung. Kontaktiere uns und wir helfen dir gerne, jedes Problem zu lösen: die Qualität unseres Supports ist ein wichtiger Grund, warum Entwickler Square Cloud mit 4,9/5 bei 402 Bewertungen auf Google und Trustpilot bewerten.

Bots

Websites

APIs und Backends

Datenbanken

Selbst gehostete Apps

Anleitungen

Migrationsleitfäden

So hostest du einen Telegram-Bot 24/7

Einführung

Voraussetzungen

Projekt erstellen

Bot-Anwendung auf Telegram

Bot entwickeln

Square Cloud konfigurieren

Bot-Token festlegen

Was in die ZIP-Datei gehört

Deployen und prüfen

Über das Dashboard

Über die CLI

Leitfaden zur Konfigurationsdatei

Bot testen

Häufige Fehler

Error 409: Conflict: terminated by other getUpdates request

Error 401: Unauthorized

Leerer Token oder `KeyError: 'TELEGRAM_BOT_TOKEN'`

Nächste Schritte

App startet nicht

Umgebungsvariablen

python-telegram-bot mit aiohttp

Kontaktiere uns

​Einführung

​Voraussetzungen

​Projekt erstellen

​Bot-Anwendung auf Telegram

​Bot entwickeln

​Square Cloud konfigurieren

​Bot-Token festlegen

​Was in die ZIP-Datei gehört

​Deployen und prüfen

​Über das Dashboard

​Über die CLI

Leitfaden zur Konfigurationsdatei

​Bot testen

​Häufige Fehler

​Error 409: Conflict: terminated by other getUpdates request

​Error 401: Unauthorized

​Leerer Token oder KeyError: 'TELEGRAM_BOT_TOKEN'

​Nächste Schritte

App startet nicht

Umgebungsvariablen

python-telegram-bot mit aiohttp

​Kontaktiere uns

Einführung

Voraussetzungen

Projekt erstellen

Bot-Anwendung auf Telegram

Bot entwickeln

Square Cloud konfigurieren

Bot-Token festlegen

Was in die ZIP-Datei gehört

Deployen und prüfen

Über das Dashboard

Über die CLI

Bot testen

Häufige Fehler

Error 409: Conflict: terminated by other getUpdates request

Error 401: Unauthorized

Leerer Token oder `KeyError: 'TELEGRAM_BOT_TOKEN'`

Nächste Schritte

Kontaktiere uns