Hilfe & Guides

✈️ Telegram-Bridge einrichten

Verbinde deinen HiveMind-Node mit Telegram und nutze deine KI überall — vom Smartphone aus.

Wie funktioniert die Telegram-Bridge?

Telegram-App (Handy)
↓ Nachricht an Bot senden
Telegram-Server (Cloud)
↓ Long-Polling / Webhook
HiveMind Gateway (dein Heim-PC)
↓ Anfrage verarbeiten
Lokales KI-Modell
↓ Antwort zurück
Telegram-App (Handy)

Dein Heim-PC verbindet sich per Long-Polling mit dem Telegram-Server — keine Port-Weiterleitungen, kein VPN nötig. Nur dein PC muss Internetzugang haben.

Schritt 1 — Bot bei BotFather erstellen

  1. BotFather öffnen

    Öffne Telegram und suche nach @BotFather (offiziell — blauer Haken). Starte den Chat mit /start.

  2. Neuen Bot erstellen

    Sende /newbot. BotFather fragt nach einem Anzeigenamen (z.B. Mein HiveMind) und einem Benutzernamen, der auf _bot enden muss (z.B. mein_hivemind_bot).

  3. Token kopieren

    BotFather antwortet mit einem Token im Format 1234567890:AAF.... Diesen Token sicher aufbewahren — er ist das Passwort deines Bots.

    🔐

    Den Bot-Token niemals öffentlich teilen! Jeder mit diesem Token kann im Namen deines Bots schreiben.

Schritt 2 — Deine Telegram-User-ID ermitteln

HiveMind antwortet nur auf Nachrichten von authorisierten Nutzern. Dafür brauchst du deine numerische Telegram-User-ID:

  1. @userinfobot öffnen

    Suche in Telegram nach @userinfobot und starte den Chat. Er antwortet sofort mit deiner User-ID, z.B. Id: 123456789.

  2. ID notieren

    Diese Zahl trägst du gleich in die Konfiguration ein — nur diese User-ID darf mit deinem Bot reden.

Schritt 3 — HiveMind konfigurieren

Öffne config.yaml und trage die Telegram-Daten ein:

telegram:
  enabled: true
  token: "1234567890:AAFdeinTokenHier"
  allowed_users:
    - 123456789          # Deine User-ID
    # weitere IDs:
    # - 987654321
  parse_mode: "Markdown"   # Markdown-Antworten
  notify_on_events: true   # Benachrichtigungen bei Node-Ereignissen

Alternativ: Im Dashboard einrichten

Statt die config.yaml manuell zu bearbeiten, kannst du die Telegram-Bridge direkt im Dashboard konfigurieren:

  1. Dashboard öffnen: http://127.0.0.1:8420
  2. In der Sidebar: Netzwerk & Soziales → Telegram
  3. Token und erlaubte User-IDs eintragen
  4. Auf "Verbindung testen" klicken
  5. Wenn "✅ Verbunden" erscheint — fertig!

Schritt 4 — Verbindung testen

  1. HiveMind (neu) starten

    Starte HiveMind oder lade die Konfiguration neu. In der Konsole sollte erscheinen: Telegram bridge started.

  2. Dem Bot schreiben

    Öffne in Telegram den Chat mit deinem Bot und sende /start. Der Bot sollte mit einer Begrüßungsnachricht antworten.

  3. Erste KI-Frage stellen

    Schreibe einfach eine normale Nachricht, z.B. "Hallo! Wer bist du?" — der Bot leitet sie an dein lokales Modell weiter und antwortet.

Bot-Befehle

BefehlFunktion
/startBegrüßung und Statusanzeige
/statusNode-Status anzeigen (CPU, RAM, Modell)
/newNeue Konversation beginnen (Kontext leeren)
/helpAlle Befehle auflisten
/image [Beschreibung]Bild generieren (falls Plugin aktiv)
/search [Begriff]Web-Suche (falls Plugin aktiv)

Mehrere Nutzer erlauben

Du kannst mehrere Telegram-User-IDs in die Whitelist eintragen. Jeder Nutzer hat eine eigene Konversationshistorie:

telegram:
  allowed_users:
    - 123456789    # Du
    - 987654321    # Partner / Familie
    - 111222333    # Freund
💡

Nicht autorisierte Nutzer, die deinem Bot schreiben, erhalten keine Antwort. Du siehst im Dashboard-Log, wenn jemand versucht, unberechtigt den Bot zu nutzen.

Tipps & Tricks

  • Längere Antworten: Telegram-Nachrichten sind auf 4096 Zeichen begrenzt. HiveMind teilt längere Antworten automatisch auf.
  • Bilder schicken: Sende einfach ein Foto — falls das Vision-Plugin aktiv ist, wird es analysiert.
  • Sprachnachrichten: Sprachnachrichten werden transkribiert (Whisper-Plugin erforderlich).
  • Bot-Beschreibung setzen: Bei BotFather mit /setdescription eine kurze Beschreibung deines Bots setzen.