ALI-FAHD/dingtalk-moltbot-connector

Was macht dingtalk-moltbot-connector?

🤖 Verbinde DingTalk mit OpenClaw Gateway für KI-gesteuerte Chat-Antworten und Sitzungsverwaltung mittels Bot- oder DEAP-Agenten-Integration.

Übersicht

Dieses Skill verbindet DingTalk mit OpenClaw Gateway, um KI-gestützte Chat-Antworten und Sitzungsverwaltung zu ermöglichen. Es nutzt entweder einen Bot oder die Integration eines DEAP-Agenten.

Funktionen

• KI-gestützte Antworten: Sende Nachrichten von DingTalk an OpenClaw Gateway und erhalte intelligente Antworten.
• Sitzungsverwaltung: Behalte den Kontext über mehrere Nachrichten hinweg mit Hilfe von Sitzungs-IDs.
• Bot-Integration: Verwende einen dedizierten DingTalk-Bot für die Interaktion.
• DEAP-Agenten-Integration: Integriere mit DEAP-Agenten für erweiterte Workflows.

Voraussetzungen

• Ein DingTalk Konto und eine konfigurierte Bot-Webhook-URL.
• Ein OpenClaw Gateway Konto mit API-Zugang.
• Python 3.8+ und die Abhängigkeiten aus requirements.txt.

Installation

1. Klone das Repository:

   git clone https://github.com/ALI-FAHD/dingtalk-moltbot-connector.git
   cd dingtalk-moltbot-connector
   

2. Installiere die Abhängigkeiten:

   pip install -r requirements.txt
   

3. Konfiguriere Umgebungsvariablen (siehe .env.example).

Konfiguration

Erstelle eine .env Datei basierend auf .env.example:

DINGTALK_WEBHOOK_URL=https://oapi.dingtalk.com/robot/send?access_token=DEIN_ACCESS_TOKEN
OPENCLAW_API_KEY=dein_openclaw_api_key
OPENCLAW_ENDPOINT=https://api.openclaw.ai/v1/chat
SESSION_TIMEOUT=300

Verwendung

Starte den Connector:

python main.py

Der Connector lauscht auf eingehende Webhooks von DingTalk, leitet die Nachrichten an OpenClaw Gateway weiter und sendet die Antwort zurück an DingTalk.

Beispiel-Nachrichtenfluss

1. Ein Benutzer sendet eine Nachricht im DingTalk-Gruppenchat, in der der Bot erwähnt wird.
2. DingTalk sendet einen Webhook an den Connector.
3. Der Connector extrahiert die Nachricht und die Sitzungs-ID (optional).
4. Die Nachricht wird an OpenClaw Gateway gesendet.
5. Die KI-generierte Antwort wird zurück an DingTalk gesendet.

API-Referenz

POST /webhook

Empfängt Nachrichten von DingTalk.

Anfragebody:

{
  "msgtype": "text",
  "text": {
    "content": "Hallo, wie geht es dir?"
  },
  "sessionId": "optional-session-id"
}

Antwort:

{
  "success": true,
  "response": "Mir geht es gut, danke!"
}

Fehlerbehandlung

• Netzwerkfehler: Die Bibliothek verwendet Wiederholungsversuche mit exponentiellem Backoff.
• Authentifizierungsfehler: Überprüfe die API-Schlüssel und Zugriffstoken.
• Timeout: Passe SESSION_TIMEOUT an.

Lizenz

MIT

Support

Bei Fragen oder Problemen erstelle bitte ein Issue im GitHub Repository.