Clawdbot Telegram Integration

Clawdbot Telegram Integrationsübersicht

Die Clawdbot Telegram Integration ermöglicht es Ihnen, Ihren persönlichen KI-Assistenten mit Telegram zu verbinden, indem Sie die Bot API über grammY verwenden. Dies ist produktionsbereit für Bot-DMs und Gruppen, mit Long-Polling als Standard und optionaler Webhook-Unterstützung.

Warum Clawdbot mit Telegram verwenden?

Telegram bietet leistungsstarke Bot-APIs und Datenschutzfunktionen. Die Integration von Clawdbot mit Telegram bietet:

Schnelleinrichtung (Anfänger)

1. Erstellen Sie einen Bot mit @BotFather (Direktlink)
2. Bestätigen Sie, dass der Handle genau @BotFather ist, dann kopieren Sie das Token
3. Setzen Sie das Token via env (TELEGRAM_BOT_TOKEN=...) oder config (channels.telegram.botToken)
4. Starten Sie das Gateway
5. DM-Zugriff ist standardmäßig Pairing; bestätigen Sie den Pairing-Code beim ersten Kontakt

Minimale Konfiguration:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing"
    }
  }
}

Clawdbot Telegram einrichten

Voraussetzungen

Bevor Sie Clawdbot mit Telegram verbinden, stellen Sie sicher, dass Sie haben:

• Clawdbot auf Ihrem Gerät installiert
• Ein Telegram-Konto
• Einen Telegram Bot Token von @BotFather

Schritt 1: Telegram Bot erstellen

Erstellen Sie einen Bot über Telegrams BotFather:

1. Öffnen Sie Telegram und chatten Sie mit @BotFather (Direktlink)
2. Bestätigen Sie, dass der Handle genau @BotFather ist
3. Führen Sie /newbot aus, dann folgen Sie den Anweisungen (Name + Benutzername endend mit bot)
4. Kopieren Sie das Token und speichern Sie es sicher

Optionale BotFather-Einstellungen:

• /setjoingroups — Erlauben/Verbieten des Hinzufügens des Bots zu Gruppen
• /setprivacy — Kontrollieren, ob der Bot alle Gruppennachrichten sieht

Schritt 2: Token konfigurieren

Setzen Sie das Token via Umgebungsvariable oder Config:

Umgebungsvariable:

TELEGRAM_BOT_TOKEN=123:abc

Konfigurationsdatei (~/.clawdbot/clawdbot.json):

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Wenn sowohl env als auch config gesetzt sind, hat config Vorrang.

Schritt 3: Gateway starten

clawdbot gateway --port 18789

Telegram startet, wenn ein Token aufgelöst wird (config zuerst, env als Fallback).

Schritt 4: Verbindung überprüfen

Überprüfen Sie Ihren Clawdbot Telegram Status:

clawdbot channels status telegram

Token + Datenschutz + Berechtigungen

Token-Erstellung (BotFather)

• /newbot erstellt den Bot und gibt das Token zurück (halten Sie es geheim)
• Wenn ein Token leakt, widerrufen/regenerieren Sie es via @BotFather und aktualisieren Sie Ihre Config

Gruppennachrichten-Sichtbarkeit (Datenschutzmodus)

Telegram-Bots sind standardmäßig im Datenschutzmodus, der einschränkt, welche Gruppennachrichten sie empfangen. Optionen:

1. Deaktivieren Sie den Datenschutzmodus mit /setprivacy
2. Fügen Sie den Bot als Gruppenadmin hinzu (Admin-Bots empfangen alle Nachrichten)

Hinweis: Wenn Sie den Datenschutzmodus umschalten, erfordert Telegram das Entfernen + erneute Hinzufügen des Bots zu jeder Gruppe, damit die Änderung wirksam wird.

Gruppenberechtigungen (Admin-Rechte)

Der Admin-Status wird innerhalb der Gruppe festgelegt (Telegram UI). Admin-Bots empfangen immer alle Gruppennachrichten.

Clawdbot Telegram Funktionen

Wie es funktioniert

• Eingehende Nachrichten werden in den gemeinsamen Kanal-Umschlag normalisiert mit Antwortkontext und Medien-Platzhaltern
• Gruppenantworten erfordern standardmäßig eine Erwähnung (native @Erwähnung oder konfigurierte Muster)
• Antworten werden immer zum selben Telegram-Chat zurückgeroutet
• Long-Polling verwendet grammY runner mit Per-Chat-Sequenzierung

Entwurf-Streaming

Clawdbot kann teilweise Antworten in Telegram DMs mit sendMessageDraft streamen.

Anforderungen:

• Threaded-Modus für den Bot in @BotFather aktiviert (Forum-Themenmodus)
• Nur private Chat-Threads
• channels.telegram.streamMode nicht auf "off" gesetzt

Entwurf-Streaming ist nur für DMs; Telegram unterstützt es nicht in Gruppen oder Kanälen.

Formatierung (Telegram HTML)

• Ausgehender Telegram-Text verwendet parse_mode: "HTML"
• Markdown-ähnliche Eingabe wird in Telegram-sicheres HTML gerendert
• Roher HTML von Modellen wird escaped, um Telegram-Parse-Fehler zu vermeiden

Befehle

Clawdbot Telegram unterstützt benutzerdefinierte Befehle:

Clawdbot Telegram Konfiguration

Vollständiges Konfigurationsbeispiel

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Zugriffskontrolle (DMs + Gruppen)

DM-Zugriff:

• dmPolicy: "pairing" — Unbekannte Absender erhalten einen Pairing-Code; genehmigen Sie via CLI
• dmPolicy: "allowlist" — Nur auf Benutzer in der Allowlist antworten
• dmPolicy: "open" — Jedem antworten (nicht empfohlen)

Gruppen-Zugriff:

• Setzen Sie channels.telegram.groups mit Gruppen-ID als Schlüssel oder "*" für alle Gruppen
• Verwenden Sie requireMention: true, um nur bei Erwähnung zu antworten

Ihre Telegram-Benutzer-ID finden

Verwenden Sie @userinfobot oder ähnliche Bots, um Ihre numerische Telegram-Benutzer-ID zu erhalten.

Clawdbot Telegram Anmeldedaten-Speicherung

Clawdbot speichert Telegram-Anmeldedaten sicher:

~/.clawdbot/credentials/telegram/bot_token
~/.clawdbot/credentials/telegram/session.json

Ihre Clawdbot Telegram Daten verbleiben auf Ihrem lokalen Rechner.

Clawdbot Telegram Fehlerbehebung

Bot antwortet nicht

Wenn Ihr Clawdbot Telegram Bot nicht antwortet:

1. Token überprüfen: clawdbot channels verify telegram
2. Bot-Status mit @BotFather prüfen
3. Logs überprüfen: cat /tmp/clawdbot/telegram.log

Gruppen-Aktivierung

Um Clawdbot in einer Gruppe zu aktivieren:

Via Config (empfohlen):

{
  "channels": {
    "telegram": {
      "groups": {
        "<group_id>": { "requireMention": true }
      }
    }
  }
}

Via Befehl (Sitzungsebene): Verwenden Sie /activate im Gruppenchat.

Gruppen-Chat-ID erhalten

Leiten Sie eine Nachricht aus der Gruppe an @userinfobot weiter oder verwenden Sie die Telegram API.

Clawdbot Telegram Best Practices

1. Pairing-Modus verwenden: Standardmäßig sicher mit Pairing-Codes
2. Datenschutzmodus konfigurieren: In @BotFather entsprechend Ihren Bedürfnissen konfigurieren
3. Rate Limits handhaben: Angemessene Rate-Limitierung implementieren
4. Nutzung überwachen: Clawdbot Telegram Bot-Analytik verfolgen

Nächste Schritte

• Clawdbot WhatsApp Integration - Verbinden Sie Clawdbot mit WhatsApp
• Clawdbot Discord Integration - Richten Sie Clawdbot auf Discord ein
• Clawdbot Einrichtungsanleitung - Vollständige Installationsanleitung