Voraussetzungen
- Ein Feishu- oder Lark-Konto mit Entwicklerzugriff
- Eine Claw-Instanz (hier erstellen)
Einrichtungsanleitung
Feishu-App erstellen
- Gehen Sie zur Feishu Open Platform (oder Lark Developer)
- Klicken Sie auf Create Custom App
- Geben Sie einen App-Namen und eine Beschreibung ein
- Klicken Sie auf Create
Bot-Funktion hinzufügen
- Gehen Sie in Ihren App-Einstellungen zu Features → Bot
- Aktivieren Sie die Bot-Funktion
- Dies ermöglicht es Ihrer App, Nachrichten zu empfangen und zu senden
Anmeldedaten abrufen
- Gehen Sie zu Credentials & Basic Info
- Kopieren Sie die App ID (beginnt mit
cli_) - Kopieren Sie das App Secret
Event-Abonnement konfigurieren
- Gehen Sie zu Event Subscriptions
- Wählen Sie den WebSocket-Modus (empfohlen — keine öffentliche URL erforderlich)
- Falls dazu aufgefordert, legen Sie den Encrypt Key und das Verification Token fest
Event-Berechtigungen hinzufügen
- Fügen Sie unter Event Subscriptions diese Events hinzu:
im.message.receive_v1— Nachrichten empfangen
- Gehen Sie zu Permissions & Scopes und fügen Sie hinzu:
im:message— Nachrichten senden und empfangenim:message.group_at_msg— Gruppen-@Erwähnungen empfangen
- Klicken Sie auf Save
App veröffentlichen
- Gehen Sie zu App Release → Version Management
- Erstellen Sie eine neue Version
- Zur Überprüfung einreichen (bei internen Apps geschieht dies normalerweise sofort)
- Sobald sie genehmigt wurde, ist die App live
Im LemonData-Dashboard konfigurieren
- Gehen Sie zu Ihrem Claw Dashboard
- Klicken Sie auf das Einstellungen-Icon Ihrer Instanz
- Öffnen Sie den Tab IM Integrations
- Erweitern Sie den Bereich Feishu
- Fügen Sie Ihre App ID und Ihr App Secret ein
- Kopieren Sie den automatisch generierten Encrypt Key und das Verification Token zurück in die Feishu-Entwicklerkonsole
- Klicken Sie auf Save
Gruppeneinstellungen
Konfigurieren Sie das Verhalten von Gruppenchats im Tab IM Integrations Ihres Dashboards:| Einstellung | Optionen | Beschreibung |
|---|---|---|
| Group Policy | Offen (Standard) / Allowlist / Deaktiviert | Steuert, wer den Bot in Gruppen auslösen kann |
| Require @mention | Ein / Aus | Bot antwortet nur, wenn er @erwähnt wird |
| Group IDs | Liste der Chat-IDs | Auf bestimmte Gruppen beschränken (leer = alle Gruppen) |
| Group Allowed Users | Liste der Open IDs | Nur diese Benutzer können den Bot auslösen (Allowlist-Modus) |
Fehlerbehebung
Bot empfängt keine Nachrichten
Bot empfängt keine Nachrichten
- Überprüfen Sie, ob die App veröffentlicht und genehmigt wurde
- Überprüfen Sie, ob das Event
im.message.receive_v1abonniert ist - Stellen Sie sicher, dass der WebSocket-Modus ausgewählt ist (nicht HTTP)
- Überprüfen Sie, ob Encrypt Key und Verification Token zwischen der Feishu-Konsole und der Claw-Konfiguration übereinstimmen
'app_ticket'-Fehler
'app_ticket'-Fehler
- Dies bedeutet normalerweise, dass die App ID oder das App Secret falsch ist
- Überprüfen Sie die Anmeldedaten in Ihrem Dashboard erneut