Buttonbaum – Technik & Einrichtung¶
Technische Eckdaten¶
| Sprache | Node.js 20 |
| Telegram-Framework | Telegraf |
| Datenbank | PostgreSQL |
| KI (optional) | Ollama mit lokalem Modell – nur für Label-Vorschläge |
| Betrieb | Docker / Docker Compose |
| Logging | Tägliche Log-Rotation |
Voraussetzungen¶
- Ein Bot-Token von @BotFather
- Die Telegram-User-ID des Admins
- Eine PostgreSQL-Datenbank (kann mitgeliefert werden)
- Optional: Ollama für KI-Vorschläge (ohne KI läuft der Bot vollständig)
Einrichtung¶
# Lieferumfang entpacken, .env ausfüllen (BOT_TOKEN, ADMIN_ID, Datenbank)
docker compose up -d --build
Beim Start legt der Bot seine Tabellen selbst an (Präfix bb_, kollisionsfrei in bestehenden Datenbanken).
Befehle¶
| Befehl | Zweck |
|---|---|
/start |
Hauptmenü öffnen |
/help |
Hilfe und Syntax-Übersicht |
/stats |
Statistiken anzeigen |
/post |
Linkbaum im aktuellen Kanal/in der Gruppe veröffentlichen |
Alles Weitere – Erstellen, Bearbeiten, Duplizieren, Export – läuft über Buttons im Hauptmenü.
Limits¶
Telegram erlaubt pro Nachricht eine begrenzte Anzahl Buttons und Zeichen. Der Bot prüft das beim Erstellen und weist auf Überschreitungen hin – große Menüs lassen sich in Untermenüs aufteilen.