OpenClaw Telegram-Kanal einrichten

OpenClaw mit Telegram zu integrieren, verwandelt deine Lieblings-Messaging-App in eine leistungsstarke Steuereinheit fr deinen KI-Agenten. Sende Befehle, lse Automatisierungen aus und erhalte Benachrichtigungen direkt ber Telegram. Dieser Guide deckt alles ab, von der Erstellung deines Bots bis zum Troubleshooting hufiger Probleme.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du hast:

• Einen Telegram-Account
• OpenClaw deployed und konfiguriert (Version 2026.2.3 oder hher empfohlen)
• Node.js (Version 24 empfohlen, 22.14+ untersttzt)
• Einen API-Key von einem Modell-Anbieter (Anthropic, OpenAI oder Google)

Schritt 1: Telegram-Bot erstellen

Jede Telegram-Integration beginnt mit einem Bot. So erstellst du einen:

1. ffne Telegram und suche nach @BotFather
2. Whle das offizielle Konto mit dem blauen verifizierten Hkchen
3. Starte einen Chat und sende /newbot
4. Folge den Prompts zur Wahl eines Anzeigenamens fr deinen Bot
5. Whle einen eindeutigen Usernamen, der auf 'bot' enden muss (z.B. MeinAssistentBot)
6. Kopiere das HTTP API-Token von BotFather bereitgestellt. Das ist essentiell fr das Verbinden von OpenClaw mit deinem Bot.

Schritt 2: OpenClaw mit dem Bot-Token konfigurieren

Jetzt fge das Token zu deiner OpenClaw-Konfiguration hinzu:

1. Greife ber die CLI (openclaw onboard), die Web-Oberflche oder durch Bearbeiten von ~/.openclaw/openclaw.json auf deine OpenClaw-Konfiguration zu
2. Navigiere zu den Telegram-Kanal-Einstellungen
3. Fge dein Bot-Token zum botToken-Feld hinzu

"channels": {
  "telegram": {
    "enabled": true,
    "dmPolicy": "pairing",
    "botToken": "DEIN_TELEGRAM_BOT_TOKEN",
    "groupPolicy": "allowlist",
    "streamMode": "partial"
  }
}

Wichtige Konfigurationsoptionen

• dmPolicy: 'pairing' (bentigt Genehmigung), 'allowlist' (vorab genehmigte User), oder 'open'
• groupPolicy: Steuert Gruppen-Chat-Zugriff
• streamMode: 'partial' fr inkrementelle Antworten, 'full' fr complete Nachrichten

Setze dmPolicy auf "pairing" fr sicheren Zugriff, zumindest zuerst.

Schritt 3: Telegram-Account koppeln

Der Kopplungsprozess stellt sicher, dass nur autorisierte User dein OpenClaw kontrollieren knnen:

1. Starte OpenClaw oder das Gateway neu, damit die nderungen wirksam werden
2. ffne Telegram und suche nach deinem neu erstellten Bot
3. Sende /start oder eine beliebige Nachricht an deinen Bot
4. Dein OpenClaw-Bot wird mit deiner Telegram-User-ID und einem Kopplungscode antworten
5. Kopiere diesen Kopplungscode
6. Genehmige die Kopplung in OpenClaw: openclaw pairing approve telegram <CODE>
7. Dein Telegram-Account ist jetzt dauerhaft auf der Allowlist

Schritt 4: Verifizieren und Testen

Besttige, dass alles funktioniert:

1. Prfe Telegram-Kanal-Status: openclaw channels status --probe
2. Du solltest sehen: Telegram aktiviert, konfiguriert, luft und funktioniert
3. Sende eine Testnachricht an deinen Bot (z.B. "Hallo")
4. Dein OpenClaw-Agent sollte antworten

Schritt 5: Fr Gruppen-Chats konfigurieren (Optional)

Wenn du deinen Bot in Telegram-Gruppen nutzen mchtest:

1. In BotFather, sende /setjoingroup, whle deinen Bot und whle "Enable"
2. Standardmig sehen Bots nur Nachrichten, die sie erwhnen
3. Um alle Nachrichten zu sehen, sende /setprivacy an BotFather, whle deinen Bot und whle "Disable"
4. Alternativ, mache deinen Bot zum Gruppen-Administrator
5. Nach dem ndern der Privatsphre-Einstellungen musst du den Bot vielleicht aus existierenden Gruppen entfernen und erneut hinzufgen

Setze in deiner OpenClaw-Konfiguration groupPolicy und channels.telegram.groups entsprechend deinem gewnschten Zugriffsmodell.

Security Best Practices

• Setze dein Bot-Token nie ffentlich. Wenn kompromittiert, regeneriere es sofort ber @BotFather
• Nutze "dmPolicy": "allowlist" und fge deine Telegram-User-ID zu allowFrom fr permanenten Zugriff
• Starte OpenClaw immer neu nach Konfigurationsnderungen
• Ein Bot-Token sollte mit einer OpenClaw-Instance verbunden sein. Erstelle separate Bots fr mehrere Agenten.

Troubleshooting hufiger Probleme

Kopplungs-Schleife

Wenn Telegram wiederholt neue Kopplungs-Codes sendet ohne die Verbindung abzuschlieen:

• Starte den OpenClaw-Container ber dein VPS-Panel neu oder: docker compose -p openclaw restart
• Sende eine neue Nachricht um einen neuen Code zu generieren und genehmige ihn sofort

Stiller Bot (Verbunden aber keine Antworten)

Die meisten stillen Bot-Probleme beziehen sich auf dmPolicy, allowFrom oder groupPolicy-Einstellungen:

• Verifiziere deine numerische Telegram-User-ID (nicht @username) in allowFrom ist
• Prfe Health-Indikator im Dashboard (sollte "Health OK" sein)
• Verifiziere "Running: Yes" und "Probe ok" im Channels-Bereich

Netzwerk- und Firewall-Probleme

Wenn der Bot still fehlschlgt, besonders whrend des ersten Polling:

• Prfe, ob deine Firewall Verbindungen zu api.telegram.org blockiert
• Nutze temporr einen mobilen Hotspot um Netzwerk-Einschrnkungen zu diagnostizieren
• Stelle sicher, dass DNS/IPv6/Proxy-Routing zu api.telegram.org korrekt konfiguriert ist

"Unsupported type"-Fehler

Wenn du "Unsupported type: … Use Raw mode" siehst:

• Installiere oder aktualisiere das oxylabs-ai-studio-openclaw Plugin auf Version 1.0.2 oder neuer
• Starte den OpenClaw-Container neu