Gilt für OpenClaw v2026.2 | Dieser Artikel setzt voraus, dass OpenClaw installiert ist und du einen Telegram Bot Token hast (kostenlos erhältlich).

TL;DR: Telegram ist der am einfachsten zu konfigurierende Kanal: Bot erstellen (@BotFather), Token erhalten, in ~/.openclaw/openclaw.json konfigurieren, Gateway starten. Standardmäßig ist DM-Pairing-Schutz aktiviert, in Gruppen muss der Bot @erwähnt werden. Außerdem: WhatsApp (QR-Code-Login), Discord (Bot Token), Slack-Konfiguration.

Warum mit Telegram beginnen?

Kanalvergleich

Gründe für Telegram

1. Einfachste Konfiguration: Nur Bot erstellen und Token erhalten
2. Beste Dokumentation: Telegram Bot API ist branchenführend
3. Umfangreichste Funktionen: Unterstützt Befehle, Buttons, Inline-Abfragen usw.
4. Aktivste Community: Problemlösungen leicht zu finden

Telegram Bot erstellen

Schritt 1: BotFather finden

1. Telegram-App öffnen
2. Nach @BotFather suchen (offizielles Bot-Verwaltungstool)
3. In den Chat klicken

sequenceDiagram
    participant U as Du
    participant BF as BotFather
    participant TG as Telegram
    
    U->>BF: /newbot
    BF->>U: Bot-Anzeigename eingeben
    U->>BF: My OpenClaw Assistant
    BF->>U: Bot-Benutzername eingeben (muss auf bot enden)
    U->>BF: myclaw_bot
    BF->>TG: Bot erstellen
    TG-->>BF: Bot erfolgreich erstellt
    BF->>U: API Token zurückgeben

Schritt 2: Neuen Bot erstellen

Sende im BotFather den Befehl:

/newbot

Folge den Anweisungen:

1. Bot-Anzeigename: z.B. My OpenClaw (Leerzeichen erlaubt)
2. Bot-Benutzername: z.B. myclaw_bot (muss auf bot enden)

Nach erfolgreicher Erstellung gibt BotFather zurück:

Done! Congratulations on your new bot...

Use this token to access the HTTP API:
7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your token secure...

⚠️ Wichtig: Bewahre den API Token sicher auf — er hat volle Kontrolle über deinen Bot.

Schritt 3: Bot-Informationen konfigurieren (optional)

# Im BotFather Bot-Profilbild setzen
/setuserpic
# Bot auswählen, Bild hochladen

# Bot-Beschreibung setzen
/setdescription
# Bot auswählen, Beschreibungstext eingeben

# Bot-Info setzen
/setabouttext
# Bot auswählen, Info-Text eingeben

# Bot-Befehle setzen
/setcommands
# Befehlsliste eingeben, z.B.:
# start - Starten
# help - Hilfe
# status - Status anzeigen

OpenClaw konfigurieren

Methode A: Umgebungsvariable (Schnelltest)

# Umgebungsvariable setzen
export TELEGRAM_BOT_TOKEN="7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Gateway starten
openclaw gateway

Methode B: Konfigurationsdatei (empfohlen für Produktion)

~/.openclaw/openclaw.json bearbeiten:

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}

Methode C: CLI-Konfiguration

# Interaktive Konfiguration
openclaw config set channels.telegram.botToken "7123456789:AAH..."

# Oder über den Onboard-Assistenten
openclaw onboard

Konfiguration überprüfen

# Konfiguration prüfen
openclaw config get channels.telegram.botToken

# Diagnose ausführen
openclaw doctor

# Gateway starten (Debug-Modus)
openclaw gateway --verbose

Nach erfolgreichem Start solltest du ähnliche Logs sehen:

[INFO] Gateway starting on port 18789
[INFO] Telegram channel connected
[INFO] Bot: @myclaw_bot
[INFO] Waiting for messages...

Sicherheitskonfiguration

DM-Pairing-Mechanismus

Standardmäßig aktiviert OpenClaw den DM-Pairing-Mechanismus (dmPolicy: "pairing"), um Missbrauch deines Bots durch Fremde zu verhindern.

sequenceDiagram
    participant S as Fremder
    participant B as Bot
    participant G as Gateway
    participant O as Du
    
    S->>B: Nachricht senden "Hallo"
    B->>G: Nachricht empfangen
    G->>G: Pairing-Status prüfen
    G-->>B: Nicht gepairt, Pairing-Code zurückgeben
    B-->>S: "Bitte pairen: Code ABC123"
    S->>O: Dir den Pairing-Code mitteilen
    O->>G: openclaw pairing approve telegram ABC123
    G->>G: Zur Whitelist hinzufügen
    G-->>S: Pairing erfolgreich, Konversation möglich

DM-Richtlinie konfigurieren

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "dmPolicy": "pairing",
      "allowFrom": []
    }
  }
}

Pairing-Anfragen verwalten

# Wartende Pairing-Liste anzeigen
openclaw pairing list

# Beispielausgabe:
# Channel    Code     User        Created
# telegram   ABC123   @stranger   2026-02-26 10:30:00

# Pairing genehmigen
openclaw pairing approve telegram ABC123

# Pairing ablehnen
openclaw pairing reject telegram ABC123

# Gepaarte Benutzer anzeigen
openclaw pairing show telegram

Whitelist-Modus

Nur bestimmte Benutzer dürfen Nachrichten senden:

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "dmPolicy": "open",
      "allowFrom": [123456789, 987654321]
    }
  }
}

💡 Telegram-Benutzer-ID ermitteln: Sende eine beliebige Nachricht an @userinfobot, und er gibt deine numerische ID zurück.

Gruppenkonfiguration

Grundlegende Gruppeneinstellung

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Differenzierte Multi-Gruppen-Konfiguration

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "groups": {
        "-100123456789": {
          "requireMention": false,
          "name": "Arbeitsgruppe"
        },
        "-100987654321": {
          "requireMention": true,
          "name": "Plaudergruppe"
        },
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

💡 Gruppen-ID ermitteln: Nachdem du den Bot zur Gruppe hinzugefügt hast, sende eine beliebige Nachricht in der Gruppe und prüfe die Gateway-Logs für die Gruppen-ID.

Bot zur Gruppe hinzufügen

1. In den Gruppeneinstellungen auf „Mitglied hinzufügen" klicken
2. Bot-Benutzernamen suchen (z.B. @myclaw_bot)
3. Hinzufügen auswählen
4. (Optional) Bot als Administrator setzen für erweiterte Berechtigungen

WhatsApp-Konfiguration

Methode: QR-Code-Login

WhatsApp nutzt das Web-Protokoll und erfordert QR-Code-Verknüpfung:

# Login-Prozess starten
openclaw channels login whatsapp

# Terminal zeigt QR-Code
# Mit dem Handy scannen:
# Einstellungen > Verknüpfte Geräte > Gerät verknüpfen > QR-Code scannen

sequenceDiagram
    participant U as Benutzer
    participant C as CLI
    participant W as WhatsApp
    participant G as Gateway
    
    U->>C: openclaw channels login whatsapp
    C->>W: QR-Code anfordern
    W-->>C: QR-Code zurückgeben
    C->>U: QR-Code anzeigen
    U->>W: Handy scannt Code
    W-->>C: Authentifizierung erfolgreich
    C->>G: Authentifizierungsinformationen speichern
    G-->>U: WhatsApp verbunden

Konfigurationsbeispiel

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

WhatsApp-Einschränkungen

Discord-Konfiguration

Discord Bot erstellen

1. Discord Developer Portal besuchen
2. Auf „New Application" klicken
3. Namen eingeben, z.B. OpenClaw Assistant
4. Zur „Bot"-Seite gehen, auf „Add Bot" klicken
5. Token kopieren (nicht die Application ID)

OAuth2-Berechtigungen konfigurieren

1. Zu „OAuth2" > „URL Generator" gehen
2. Folgende Berechtigungen aktivieren:

3. Generierte Einladungs-URL kopieren
4. URL im Browser öffnen und Bot zum Server einladen

Konfigurationsbeispiel

{
  "channels": {
    "discord": {
      "token": "MTk4NjIyNDgzNDc...",
      "guilds": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Discord-spezifische Konfiguration

{
  "channels": {
    "discord": {
      "token": "your_token",
      "commands": {
        "native": true,
        "text": true
      },
      "mediaMaxMb": 25
    }
  }
}

Slack-Konfiguration

Slack App erstellen

1. Slack API besuchen
2. Auf „Create New App" klicken
3. „From scratch" auswählen
4. App-Name eingeben, Workspace auswählen

OAuth-Berechtigungen konfigurieren

Auf der Seite „OAuth & Permissions" folgende Bot Token Scopes hinzufügen:

app_mentions:read
channels:history
channels:read
chat:write
files:read
files:write
groups:history
groups:read
im:history
im:read
im:write
mpim:history
mpim:read
mpim:write
reactions:read
reactions:write
users:read

Im Workspace installieren

1. Auf „Install to Workspace" klicken
2. Berechtigungen autorisieren
3. Bot User OAuth Token kopieren (beginnt mit xoxb-)

Konfigurationsbeispiel

{
  "channels": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "signingSecret": "..."
    }
  }
}

Socket Mode aktivieren (empfohlen)

1. Auf der „Socket Mode"-Seite aktivieren
2. App-Level Token generieren
3. In OpenClaw konfigurieren:

{
  "channels": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "socketMode": true
    }
  }
}

Mehrere Kanäle gleichzeitig aktivieren

Vollständiges Konfigurationsbeispiel

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback"
  },
  "channels": {
    "telegram": {
      "botToken": "telegram_bot_token",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"]
    },
    "discord": {
      "token": "discord_token",
      "guilds": {
        "*": { "requireMention": true }
      }
    },
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

Nachrichtenrouting-Diagramm

flowchart TB
    subgraph Users["Benutzer"]
        WA[WhatsApp-Benutzer]
        TG[Telegram-Benutzer]
        DC[Discord-Benutzer]
        SL[Slack-Benutzer]
    end
    
    subgraph Gateway["Gateway"]
        MR[Message Router]
        SM[Session Manager]
    end
    
    subgraph Agent["Pi Agent"]
        AI[KI-Kern]
        CTX[Gemeinsamer Kontext]
    end
    
    WA --> MR
    TG --> MR
    DC --> MR
    SL --> MR
    MR --> SM
    SM --> AI
    AI --> CTX

Alle Kanäle teilen sich denselben Agent, der Kontext wird einheitlich verwaltet. Das bedeutet:

• Eine in Telegram gestellte Frage kann in WhatsApp weiterbesprochen werden
• Benutzer verschiedener Kanäle können dasselbe Gedächtnis teilen
• Jeder Kanal kann eigene Sitzungsisolierungsrichtlinien haben

Sitzungsverwaltungsbefehle

Universelle Befehle für alle Kanäle (im Chat senden):

Fehlerbehebung

Telegram Bot antwortet nicht

Symptom: Keine Antwort nach dem Senden einer Nachricht

Diagnoseschritte:

# 1. Prüfen ob Gateway läuft
curl http://127.0.0.1:18789/health

# 2. Bot Token prüfen
openclaw config get channels.telegram.botToken

# 3. Detaillierte Logs anzeigen
openclaw gateway --verbose

# 4. Diagnose durchführen
openclaw doctor

Häufige Ursachen:

WhatsApp QR-Code-Scan fehlgeschlagen

Symptom: Nach dem Scannen wird ein Fehler angezeigt

Lösung:

# QR-Code neu generieren
openclaw channels logout whatsapp
openclaw channels login whatsapp

# Netzwerk prüfen
ping web.whatsapp.com

# Anmeldedaten-Cache löschen
rm -rf ~/.openclaw/credentials/whatsapp*

Discord Bot ohne Berechtigungen

Symptom: Bot reagiert nicht oder hat keine Berechtigungen im Server

Lösung:

1. Bot-Rollenberechtigungen prüfen
2. Sicherstellen, dass der Bot zum Server eingeladen wurde
3. Bot erneut einladen (mit korrekter OAuth URL)

# Berechtigungsfehler in den Logs suchen
openclaw gateway --verbose 2>&1 | grep -i permission

Konfiguration wird nicht übernommen

Symptom: Nach Konfigurationsänderung kein geändertes Verhalten

Lösung:

# 1. Gateway neustarten
openclaw gateway --restart

# 2. Cache löschen
rm -rf ~/.openclaw/cache/*

# 3. Konfigurationsdatei-Syntax prüfen
cat ~/.openclaw/openclaw.json | jq .

# 4. Konfigurationspriorität prüfen
openclaw config list

Sicherheits-Best-Practices

1. Token-Sicherheit

# Token nicht in Versionskontrolle committen
echo ".openclaw/" >> .gitignore

# Umgebungsvariablen für sensible Informationen verwenden
export TELEGRAM_BOT_TOKEN="your_token"

# Token regelmäßig rotieren (im BotFather)
# /revoke Befehl kann den Token neu generieren

2. Zugriffskontrolle

{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing",
      "allowFrom": [],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  },
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

3. Log-Audit

# Detaillierte Logs aktivieren
openclaw gateway --verbose

# Sitzungsverlauf anzeigen
openclaw sessions list
openclaw sessions show <session-id>

# Befehlsausführung auditieren
grep "bash" ~/.openclaw/logs/gateway.log

Nächste Schritte

Herzlichen Glückwunsch! Du hast den ersten Kanal erfolgreich konfiguriert. Jetzt kannst du:

1. Dialog testen → Nachrichten im konfigurierten Kanal senden
2. Skills installieren → KI-Fähigkeiten erweitern
3. Mehrere Kanäle konfigurieren → Weitere Kanäle hinzufügen

Zusammenfassung dieses Artikels:

• Telegram Bot-Erstellung und -Konfiguration beherrscht
• DM-Pairing und Gruppenkonfiguration verstanden
• WhatsApp, Discord, Slack Konfigurationsmethoden erlernt
• Multi-Kanal-Gleichzeitaktivierung kennengelernt
• Häufige Fehlerbehebungsmethoden beherrscht

Änderungsprotokoll:

• 2026-02-26: Erstveröffentlichung, basierend auf OpenClaw v2026.2

Seriennavigation:

• ← Vorheriger Artikel: Umgebungseinrichtung und erster Start
• → Nächster Artikel: Gateway-Kernkonzepte