OpenClaw DingTalk Kanal

OpenClaw verbindet sich mit DingTalk über den Stream-Modus (WebSocket-Langverbindung) der DingTalk Open Platform. Im Gegensatz zu herkömmlichen Webhooks initiiert das Gateway aktiv eine WebSocket-Verbindung zu den DingTalk-Servern und empfängt Event-Pushes in Echtzeit — keine öffentliche IP oder Domain erforderlich. Nachrichtenfluss: Benutzer sendet Nachricht in DingTalk → DingTalk Open Platform → Stream-Push zum Gateway → OpenClaw verarbeitet mit KI → Antwort über DingTalk Bot API → Nachricht wird in DingTalk zugestellt. Diese Architektur eignet sich hervorragend für Self-Hosted-Deployments hinter NAT oder Unternehmens-Firewalls. Das Gateway verwaltet die Verbindung automatisch und behandelt Verbindungsabbrüche mit exponentiellem Backoff.

Für die DingTalk-Anbindung stehen zwei Community-Plugins zur Verfügung: • @soimy/dingtalk — Das beliebteste Plugin, aktiv von der Community gepflegt. Unterstützt Markdown- und KI-Card-Antwortformate, umfassend und stabil. • @dingtalk-real-ai/dingtalk-connector — Ein mit DingTalk offiziell verbundenes Projekt, fokussiert auf KI-Card-Streaming-Antworten, unterstützt Multi-Agent-Routing und asynchronen Modus, erfordert OpenClaw v0.7.7+. Beide Plugins nutzen den Stream-Modus, das Kernerlebnis ist identisch. Empfehlung: Einsteiger nehmen die @soimy-Version (mehr Dokumentation), wer Multi-Agent oder asynchrone Verarbeitung braucht, nimmt die @dingtalk-real-ai-Version.

# @soimy-Version installieren (empfohlen)
openclaw plugins install @soimy/dingtalk

# Oder @dingtalk-real-ai-Version installieren
openclaw plugins install @dingtalk-real-ai/dingtalk-connector

Die Einrichtung der DingTalk-Integration erfordert das Erstellen einer App auf der DingTalk Open Platform: 1. Melden Sie sich bei open-dev.dingtalk.com an und gehen Sie zur Entwicklerkonsole. 2. Klicken Sie auf 'App erstellen', wählen Sie 'Interne Unternehmensentwicklung' → Typ 'Bot'. 3. Geben Sie App-Name und Beschreibung ein. Nach der Erstellung kopieren Sie auf der Seite 'Anmeldedaten und Basisinformationen' die ClientID (AppKey, Format dingXXX) und das ClientSecret (AppSecret). 4. Wählen Sie in der Bot-Konfiguration den **Stream-Modus** als Nachrichtenempfangsmodus (nicht HTTP-Modus). 5. Fügen Sie in der Berechtigungsverwaltung die erforderlichen Berechtigungen hinzu: - qyapi_robot_sendmsg (Bot-Nachrichtenversand) - Card.Instance.Write (Karteninstanz-Schreibzugriff) - Card.Streaming.Write (Streaming-Karten-Schreibzugriff) - mediaId.download und mediaId.upload (Medien-Upload/-Download) 6. Veröffentlichen Sie die App und warten Sie auf die Genehmigung des Organisationsadministrators.

# Über Umgebungsvariablen
export DINGTALK_CLIENT_ID="dingXXXXXX"
export DINGTALK_CLIENT_SECRET="your_app_secret"

# Oder über CLI
openclaw channels add

Das DingTalk-Plugin unterstützt flexible Nachrichtenrichtlinien: **DM-Richtlinie (dmPolicy)**: • open — Jeder kann dem Bot Direktnachrichten senden und erhält eine Antwort • disabled — DM-Funktionalität ist deaktiviert **Gruppenchat-Richtlinie (groupPolicy)**: • open — Jedes Gruppenmitglied kann den Bot per @Erwähnung auslösen • disabled — Gruppennachrichten werden komplett ignoriert In Gruppenchats ist standardmäßig eine @Erwähnung des Bots erforderlich, um unnötige Antworten in aktiven Gruppen zu vermeiden.

{
  "channels": {
    "dingtalk": {
      "dmPolicy": "open",
      "groupPolicy": "open"
    }
  }
}

Das DingTalk-Plugin unterstützt mehrere Antwortformate: • **Text** — Einfache Nur-Text-Antworten • **Markdown** — Unterstützt Überschriften, Listen, Links und andere Formatierungen, standardmäßig empfohlen • **KI-Card (Streaming)** — Schreibmaschineneffekt ähnlich ChatGPT, die Nachricht wird in einer Karte schrittweise aktualisiert Das KI-Card-Streaming bietet die beste Benutzererfahrung — Nachrichten werden an Ort und Stelle aktualisiert, ohne mehrere Nachrichten zu erzeugen. Erfordert Card-Berechtigungen in der DingTalk-App.

{
  "channels": {
    "dingtalk": {
      "messageType": "markdown",
      "streaming": true
    }
  }
}

Das OpenClaw DingTalk-Plugin verarbeitet verschiedene Nachrichtentypen: **Empfang**: Text, Bilder, Sprache (automatische Spracherkennung), Video, Dateien **Dateiverarbeitung**: .docx, .pdf, .txt, .md, .json, .xlsx, .pptx, .zip und andere Formate können von der KI gelesen und analysiert werden **Versand**: Text, Markdown, KI-Card, Bilder, Dateien Sprachnachrichten werden automatisch in Text umgewandelt und an die KI weitergeleitet — keine zusätzliche Konfiguration erforderlich.

Mit der @dingtalk-real-ai-Version des Plugins können Sie Multi-Agent-Routing konfigurieren, sodass verschiedene KI-Agenten verschiedene Konversationstypen bearbeiten. Zum Beispiel: Direktnachrichten gehen an den allgemeinen Assistenten, bestimmte Gruppenchats an einen Fach-Agenten. Über die bindings-Konfiguration in OpenClaw können Sie die Agent-Zuweisung pro Konversation feingranular steuern.

{
  "bindings": [
    { "agentId": "main", "match": { "channel": "dingtalk", "peer": { "kind": "direct" } } },
    { "agentId": "tech-support", "match": { "channel": "dingtalk", "peer": { "kind": "group" } } }
  ]
}

OpenClaw bietet mehrere Befehle zur Verwaltung Ihres DingTalk-Bots: • openclaw gateway status — Gateway-Verbindungsstatus prüfen • openclaw gateway restart — Gateway-Dienst neu starten • openclaw logs --follow — Echtzeit-Logs anzeigen • openclaw channels add — Kanal interaktiv hinzufügen • openclaw plugins list — Installierte Plugins anzeigen • openclaw plugins update @soimy/dingtalk — DingTalk-Plugin aktualisieren • openclaw doctor — Umfassende Diagnose