Warum Feishu?
Feishu (飞书), international als Lark bekannt, ist ByteDances Plattform für Unternehmenszusammenarbeit — weit verbreitet in chinesischen Technologieunternehmen, Startups und zunehmend in Südostasien. Mit OpenClaw v2026.2.2 wurde Feishu zum ersten offiziell unterstützten chinesischen Chat-Client der Plattform.
- •Keine öffentliche URL erforderlich — kein ngrok, keine Domain, kein Webhook-Server
- •Funktioniert hinter Firewalls — die Verbindung ist ausgehend von Ihrem Rechner
- •Niedrige Latenz — bidirektionale Echtzeit-Kommunikation
- •Unterstützung für reichhaltige Inhalte — Text, Bilder, Dateien, Audio, Video und Sticker
Voraussetzungen
- •OpenClaw v2026.2.2 oder höher
- •Ein Feishu/Lark-Unternehmenskonto (kostenlose Stufe funktioniert)
- •Admin-Zugriff zum Erstellen von Apps auf der Feishu Open Platform
Schritt 1: Eine Feishu-App erstellen
- 1.Gehen Sie zur Feishu Open Platform (oder Lark Developer Console für internationale Tenants)
- 2.Klicken Sie auf Create Custom App
- 3.Legen Sie den App-Namen (z. B. „OpenClaw Agent“) und die Beschreibung fest
- 4.Laden Sie ein Symbol hoch (das OpenClaw-Hummer-Logo eignet sich gut)
- 5.Kopieren Sie die App ID (Format:
cli_xxx) und das App Secret von der Credentials-Seite
Schritt 2: App-Berechtigungen konfigurieren
Aktivieren Sie in den Berechtigungseinstellungen Ihrer App diese Bereiche:
| Berechtigung | Zweck |
|---|---|
im:message | Nachrichten senden und empfangen |
im:message.group_at_msg | @Erwähnungen in Gruppenchats empfangen |
im:resource | Auf Bilder und Dateien zugreifen |
contact:user.id:readonly | Benutzer identifizieren |
Nach dem Hinzufügen der Berechtigungen klicken Sie auf Publish, um zur Überprüfung einzureichen. In den meisten Unternehmens-Tenants werden selbst erstellte Apps automatisch genehmigt.
Schritt 3: Event-Subscription aktivieren
- 1.Gehen Sie in den App-Einstellungen zu Event Subscriptions
- 2.Wählen Sie WebSocket Mode (Langzeitverbindung) — das ist entscheidend. Verwenden Sie NICHT den Webhook-Modus, da dieser eine öffentliche URL erfordert.
- 3.Abonnieren Sie diese Events:
Schritt 4: OpenClaw konfigurieren
Fügen Sie die Feishu-Anmeldedaten zu Ihrer OpenClaw-Konfiguration hinzu. Bearbeiten Sie ~/.openclaw/.env:
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=your_app_secret_here
Oder wenn Sie die OpenClaw-Konfigurationsdatei verwenden (~/.openclaw/config.yaml):
channels:
feishu:
enabled: true
appId: cli_xxxxxxxxxxxxx
appSecret: your_app_secret_here
Starten Sie OpenClaw neu:
openclaw restart
Sie sollten eine Log-Nachricht sehen, die bestätigt, dass die Feishu WebSocket-Verbindung hergestellt wurde.
Schritt 5: Die Verbindung testen
Öffnen Sie Feishu und finden Sie Ihre App in der Chat-Liste (suchen Sie nach dem App-Namen, den Sie in Schritt 1 festgelegt haben). Senden Sie eine Nachricht:
> Hallo!
- •Textnachrichten
- •Bilder (der Agent kann diese analysieren, wenn ein bildverarbeitungsfähiges Modell verwendet wird)
- •Dateien (der Agent kann Dokumente lesen)
- •Sprachnachrichten (werden transkribiert und als Text verarbeitet)
Gruppenchat-Konfiguration
OpenClaw unterstützt Feishu-Gruppenchats mit drei Zugriffsmodi:
| Modus | Verhalten |
|---|---|
open (Standard) | Jedes Gruppenmitglied kann den Bot auslösen, wenn es @erwähnt wird |
allowlist | Nur zugelassene Benutzer können interagieren, auch mit @Erwähnung |
disabled | Gruppennachrichten werden vollständig ignoriert |
Konfigurieren Sie in config.yaml:
channels:
feishu:
groupAccess: open # or "allowlist" or "disabled"
allowedUsers: # only used with "allowlist" mode
- user_id_1
- user_id_2
In Gruppenchats antwortet der Agent nur, wenn er @erwähnt wird, um Störungen in stark frequentierten Kanälen zu vermeiden.
Streaming-Antworten
OpenClaw unterstützt Streaming von KI-Antworten in Feishu mithilfe interaktiver Karten. Anstatt auf die vollständige Antwort zu warten, sendet der Agent eine erste Karte und aktualisiert sie in Echtzeit, während die KI Text generiert. Dies bietet ein deutlich besseres Nutzererlebnis bei langen Antworten.
Streaming ist standardmäßig aktiviert. Um es zu deaktivieren:
channels:
feishu:
streaming: false
Unterstützte Nachrichtentypen
| Richtung | Unterstützte Typen |
|---|---|
| Eingehend (Nutzer an Agent) | Text, Rich Text (Post), Bilder, Dateien, Audio, Video, Sticker |
| Ausgehend (Agent an Nutzer) | Text, Bilder, Dateien, Audio, interaktive Karten |
Fehlerbehebung
„App not found“-Fehler: Stellen Sie sicher, dass die App in Ihrem Feishu-Tenant veröffentlicht und genehmigt ist. Selbst erstellte Apps in Unternehmens-Tenants werden normalerweise automatisch genehmigt, aber einige Organisationen erfordern eine Admin-Genehmigung.
Keine Antwort vom Agenten: Überprüfen Sie die OpenClaw-Logs (openclaw logs) auf WebSocket-Verbindungsfehler. Stellen Sie sicher, dass App ID und App Secret korrekt sind.
Nachrichten kommen nicht in Gruppenchats an: Stellen Sie sicher, dass der Bot zur Gruppe hinzugefügt wurde und dass der Benutzer den Bot korrekt @erwähnt. Überprüfen Sie die groupAccess-Einstellung.
Verbindungsabbrüche: Die WebSocket-Verbindung stellt sich automatisch wieder her. Wenn Abbrüche häufig auftreten, überprüfen Sie Ihre Netzwerkstabilität oder Firewall-Einstellungen.
Verwendung der Community-Brücke (Alternative)
Wenn Sie Funktionen über die native Integration hinaus benötigen, bietet die von der Community gepflegte feishu-openclaw-Brücke von AlexAnys zusätzliche Funktionen wie benutzerdefinierte Nachrichtenformatierung und erweiterte Gruppenverwaltung. Die Einrichtung dauert etwa 5 Minuten und erfordert keinen öffentlichen Server.
Für die vollständige Dokumentation siehe den offiziellen Feishu-Kanal-Leitfaden.