OpenClaw Feishu/Lark Integration: Vollstaendige Einrichtungsanleitung
Verbinden Sie OpenClaw mit Feishu oder Lark. Schritt-fuer-Schritt-Anleitung zu App-Erstellung, Berechtigungen, WebSocket-Einrichtung und Fehlerbehebung.
OpenClaw Guides
Tutorial Authors
Feishu vs Lark: Zwei Plattformen, eine OpenClaw-Integration
Feishu und Lark sind die Enterprise-Messaging-Plattformen von ByteDance — Feishu fuer den chinesischen Markt, Lark fuer den internationalen Einsatz. Da beide auf derselben Architektur basieren, ist der Integrationsprozess nahezu identisch, unabhaengig davon, welche Version Ihre Organisation nutzt.
OpenClaw bietet zwei Wege, um sich mit Feishu/Lark zu verbinden:
| Integriertes Plugin (Empfohlen) | Offizielles Feishu Plugin | |
|---|---|---|
| Betreut von | OpenClaw Community | Feishu/Lark Team (ByteDance) |
| Identitaet | Bot | Benutzer-Proxy (OAuth) |
| Funktionsumfang | Messaging, einfaches Lesen von Dokumenten | Voller Workspace-Zugriff: Dokumente, Kalender, Aufgaben, Tabellen, Wiki |
| Installation | Integriert, keine Zusatzinstallation | feishu-plugin-onboard install |
| Komplexitaet | Mittel | Hoeher |
| Geeignet fuer | Schnelles Messaging-Setup | Teams mit KI-Workspace-Zugriff |
Diese Anleitung konzentriert sich auf das integrierte Plugin, das rund 90 % aller Anwendungsfaelle abdeckt. Falls Sie vollen Workspace-Zugriff benoetigen (Dokumente lesen, Kalender verwalten, Aufgaben erstellen), finden Sie im Abschnitt Offizielles Feishu Plugin weitere Informationen.
Voraussetzungen fuer die OpenClaw Feishu-Einrichtung
Bevor Sie beginnen, stellen Sie sicher, dass Folgendes vorhanden ist:
- OpenClaw installiert und lauffaehig (Version ≥ 2026.2). Falls noch nicht geschehen, folgen Sie der Installationsanleitung.
- Ein Feishu-Entwicklerkonto auf open.feishu.cn (oder open.larksuite.com fuer Lark).
- Gateway erreichbar — pruefen Sie mit:
openclaw gateway status
Keine oeffentliche IP oder Domain erforderlich. Das integrierte Plugin nutzt standardmaessig den WebSocket-Modus, der eine ausgehende Verbindung zu den Feishu-Servern herstellt. Das funktioniert hinter NAT, Firewalls und den meisten Unternehmensnetzwerken — ohne Portweiterleitung.
Schritt 1: Feishu/Lark Bot-App erstellen
Entwicklerkonsole oeffnen
Navigieren Sie zum Entwicklerportal Ihrer Plattform:
- Feishu (China): open.feishu.cn → Developer Console
- Lark (International): open.larksuite.com → Developer Console
Anwendung erstellen
- Klicken Sie auf Create Custom App (oder "Enterprise Self-Built Application", je nach Oberflaeche)
- Geben Sie einen aussagekraeftigen App-Namen ein, z. B. "OpenClaw Assistant"
- Optional: Fuegen Sie ein Icon und eine Beschreibung hinzu — das ist das, was Benutzer im Bot-Verzeichnis sehen
Zugangsdaten kopieren
- Gehen Sie zu Credentials & Basic Info in der linken Seitenleiste
- Kopieren Sie die App ID (sieht aus wie
cli_a5xxxxxxxxxxxxx) - Kopieren Sie das App Secret
⚠️ Bewahren Sie Ihr App Secret sicher auf. Committen Sie es niemals in die Versionskontrolle, teilen Sie es nicht im Chat und zeigen Sie es nicht in Screenshots. Falls es kompromittiert wird, setzen Sie es sofort in der Entwicklerkonsole zurueck.
Schritt 2: Feishu Bot-Berechtigungen konfigurieren
Ihre App benoetigt bestimmte Berechtigungen (Scopes), um Nachrichten senden und empfangen zu koennen. Es gibt zwei Wege, diese einzurichten.
Option A: Massenimport (Empfohlen)
Der schnellste Ansatz — fuegen Sie einen JSON-Block ein und alle Berechtigungen werden auf einmal aktiviert.
- Gehen Sie in den App-Einstellungen zu Development Settings → Permission Management
- Klicken Sie auf Batch Enable (oder "Batch Import Scopes")
- Fuegen Sie folgenden JSON-Block ein:
{
"scopes": {
"tenant": [
"im:chat", "im:message", "im:message:send_as_bot",
"im:message.p2p_msg:readonly", "im:message.group_at_msg:readonly",
"im:message.group_msg", "im:message:readonly", "im:resource",
"im:chat.members:bot_access",
"im:chat.access_event.bot_p2p_chat:read",
"contact:user.employee_id:readonly",
"application:application:self_manage", "application:bot.menu:write",
"cardkit:card:write",
"docs:document.content:read", "sheets:spreadsheet",
"wiki:wiki:readonly", "event:ip_list"
],
"user": [
"im:chat.access_event.bot_p2p_chat:read"
]
}
}
- Klicken Sie auf Confirm, um die Berechtigungen zu uebernehmen
Option B: Manuelle Auswahl
Falls der Massenimport in Ihrer Konsolenversion nicht verfuegbar ist, aktivieren Sie diese Berechtigungen einzeln unter Permission Management:
im:message— Nachrichten senden und empfangenim:message:send_as_bot— Nachrichten als Bot sendenim:message.p2p_msg:readonly— Direktnachrichten lesenim:message.group_at_msg:readonly— @Erwaehnung-Nachrichten in Gruppen lesenim:message.group_msg— Alle Gruppennachrichten lesenim:resource— Auf Nachrichtenressourcen zugreifen (Bilder, Dateien)im:chat— Chat-Metadaten abrufenim:chat.members:bot_access— Bot-Mitgliedschaft in Chats pruefencontact:user.employee_id:readonly— Benutzer-IDs lesendocs:document.content:read— Dokumentinhalte lesen (optional, fuer Zusammenfassungen)sheets:spreadsheet— Auf Tabellen zugreifen (optional)wiki:wiki:readonly— Wiki-Seiten lesen (optional)
Die Berechtigungen fuer Dokumente, Tabellen und Wiki sind optional. Aktivieren Sie diese nur, wenn der Bot in der Lage sein soll, im Chat geteilte Dokumente zu lesen und zusammenzufassen.
Schritt 3: Feishu Bot und Event-Abonnements aktivieren
Bot-Funktion aktivieren
- Gehen Sie in der linken Seitenleiste zu App Capabilities → Bot
- Schalten Sie die Bot-Funktion ein
- Optional: Legen Sie eine Bot-Beschreibung und einen Hilfetext fest
Event-Abonnements konfigurieren
Dies ist der entscheidende Schritt, der Feishu anweist, Nachrichten an Ihre OpenClaw-Instanz weiterzuleiten.
- Gehen Sie zu Events & Callbacks → Event Subscriptions
- Waehlen Sie als Connection Mode die Option Long Connection (WebSocket)
- Fuegen Sie folgende Events hinzu:
| Event | Name | Erforderlich? |
|---|---|---|
im.message.receive_v1 | Nachrichten empfangen | Ja |
im.message.reaction.created_v1 | Emoji-Reaktion hinzugefuegt | Optional |
im.message.reaction.deleted_v1 | Emoji-Reaktion entfernt | Optional |
application.bot.menu_v6 | Benutzerdefiniertes Bot-Menue | Optional |
Das Event im.message.receive_v1 ist das einzige zwingend erforderliche — ohne dieses empfaengt Ihr Bot keine Nachrichten. Die Reaktions-Events sind nuetzlich, wenn Sie Aktionen basierend auf Emoji-Antworten ausloesen moechten (z. B. Daumen hoch zur Bestaetigung).
⚠️ Ohne Event-Abonnements erscheint kein Eingabefeld, wenn Benutzer eine Konversation mit Ihrem Bot in Feishu/Lark oeffnen. Falls Benutzer das Bot-Profil sehen, aber nichts eingeben koennen, liegt es fast immer daran.
⚠️ Dies ist die haeufigste Ursache fuer den Fehler "app has not established a long connection". Wenn Sie diesen Fehler in den Logs sehen, ueberpruefen Sie, ob Sie mindestens das Event im.message.receive_v1 hinzugefuegt und den Modus Long Connection gewaehlt haben.
Schritt 4: Feishu-App veroeffentlichen
Ihre App ist fuer Benutzer erst sichtbar, nachdem Sie sie veroeffentlicht haben.
- Gehen Sie zu Version Management in der linken Seitenleiste
- Klicken Sie auf Create Version
- Geben Sie eine Versionsnummer ein (z. B.
1.0.0) und fuegen Sie Release Notes hinzu - Klicken Sie auf Submit for Review
Bei internen Unternehmens-Apps erfolgt die Freigabe in der Regel automatisch, wenn Sie Tenant-Administrator sind (oder ein Admin mit vollem Bereich). Als regulaerer Entwickler kann die App den konfigurierten Pruefprozess Ihrer Organisation durchlaufen — wenden Sie sich an Ihren Administrator.
Nach der Veroeffentlichung:
- Oeffnen Sie Feishu (oder Lark) auf Desktop oder Mobilgeraet
- Gehen Sie zum App-Verzeichnis oder zur Suchleiste
- Suchen Sie nach Ihrem App-Namen
- Der Bot sollte angezeigt werden — schreiben Sie ihm aber noch nicht. Konfigurieren Sie zuerst OpenClaw.
Schritt 5: OpenClaw Feishu-Kanal konfigurieren
Schnelleinrichtung per CLI
Der schnellste Weg zur Verbindung:
openclaw channels add # Waehlen Sie "Feishu", dann App ID und Secret eingeben openclaw gateway restart
Das CLI fuehrt Sie interaktiv durch die wichtigsten Einstellungen.
Manuelle Konfiguration
Fuer mehr Kontrolle bearbeiten Sie ~/.openclaw/openclaw.json direkt:
{
channels: {
feishu: {
enabled: true,
domain: "feishu", // Verwenden Sie "lark" fuer Lark International
connectionMode: "websocket",
dmPolicy: "pairing",
groupPolicy: "open",
requireMention: true,
streaming: true,
typingIndicator: true,
accounts: {
main: {
appId: "cli_a5xxxxxxxxxxxxx",
appSecret: "your-app-secret",
botName: "AI Assistant"
}
}
}
}
}
Konfigurationsreferenz
| Option | Standard | Beschreibung |
|---|---|---|
domain | "feishu" | "feishu" fuer China, "lark" fuer internationales Lark |
connectionMode | "websocket" | "websocket" (empfohlen) oder "webhook" |
dmPolicy | "pairing" | Direktnachrichten-Zugriff: pairing / open / allowlist / disabled |
groupPolicy | "open" | Gruppenzugriff: open / allowlist / disabled |
requireMention | true | Ob eine @Erwaehnung noetig ist, um den Bot in Gruppen auszuloesen |
streaming | true | Streaming-Ausgabe aktivieren (Schreibmaschinen-Effekt) |
typingIndicator | true | "Tippt..."-Anzeige waehrend der Generierung anzeigen |
textChunkLimit | 2000 | Maximale Zeichen pro Nachrichtenblock |
mediaMaxMb | 30 | Maximale Mediendateigroesse in MB |
Feishu vs Lark Domain: Der einzige Unterschied ist das Feld
domain. Setzen Sie es auf"feishu", wenn Ihre Organisation Feishu (China) nutzt, oder auf"lark"fuer Lark (International). Alles andere — Zugangsdaten, Berechtigungen, Events — funktioniert identisch.
Schritt 6: OpenClaw Gateway starten und Feishu koppeln
Gateway starten
openclaw gateway # Gateway starten (Vordergrund)
In einem separaten Terminal koennen Sie die Logs verfolgen:
openclaw logs --follow # Logs in Echtzeit streamen
Sie sollten eine Ausgabe wie diese sehen:
[feishu] WebSocket connected to wss://open.feishu.cn/... [feishu] Bot "AI Assistant" is online
Konto koppeln (Pairing)
Die Standard-DM-Richtlinie ist pairing. Das bedeutet, dass neue Benutzer zuerst genehmigt werden muessen, bevor sie mit dem Bot chatten koennen. Dies verhindert unbefugten Zugriff.
- Oeffnen Sie Feishu (oder Lark) und suchen Sie Ihren Bot
- Senden Sie eine beliebige Nachricht — "Hallo" reicht voellig aus
- Pruefen Sie Ihr Terminal. Sie sehen eine Kopplungsanfrage mit einem Code:
[feishu] New pairing request from user_xxxxx (Code: ABC123)
- Genehmigen Sie die Kopplung:
openclaw pairing approve feishu ABC123
- Gehen Sie zurueck zu Feishu/Lark und senden Sie eine weitere Nachricht
- Die KI sollte nun antworten
Verbindung ueberpruefen
openclaw gateway status
Erwartete Ausgabe:
Feishu: connected (websocket) Account: main Bot: AI Assistant Paired users: 1 Active groups: 0
Falls der Status disconnected anzeigt, lesen Sie den Abschnitt Fehlerbehebung weiter unten.
Feishu Gruppenchat-Konfiguration fuer OpenClaw
Standardmaessig erlaubt groupPolicy: "open" dem Bot, jeder Gruppe beizutreten, zu der er hinzugefuegt wird. Fuer mehr Kontrolle verwenden Sie eine Allowlist:
{
channels: {
feishu: {
groupPolicy: "allowlist",
requireMention: true,
groups: {
"oc_xxxxxxxxx": { // Feishu Chat-ID
agentId: "main",
requireMention: false // Ueberschreibung: auf alle Nachrichten in dieser Gruppe reagieren
},
"oc_yyyyyyyyy": {
agentId: "support", // An einen anderen Agent weiterleiten
requireMention: true
}
}
}
}
}
Um die Chat-ID einer Gruppe herauszufinden, fuegen Sie den Bot zur Gruppe hinzu und pruefen Sie die Logs — die ID wird beim Beitritt angezeigt.
Tipp: Setzen Sie
requireMention: trueglobal und ueberschreiben Sie es pro Gruppe. So vermeiden Sie, dass der Bot in grossen Kanaelen stoerend wirkt, waehrend in dedizierten KI-Gruppen freie Konversation moeglich ist.
Feishu Webhook-Modus einrichten
WebSocket ist der empfohlene Verbindungsmodus, aber einige Unternehmensnetzwerke blockieren persistente ausgehende WebSocket-Verbindungen. In diesem Fall wechseln Sie zum Webhook-Modus:
{
channels: {
feishu: {
connectionMode: "webhook",
verificationToken: "from-feishu-console",
encryptKey: "from-feishu-console",
webhookPath: "/feishu/events",
webhookPort: 3000
}
}
}
So erhalten Sie Verification Token und Encrypt Key:
- Gehen Sie in den Feishu-App-Einstellungen zu Events & Callbacks → Encryption Strategy
- Kopieren Sie Verification Token und Encrypt Key
Konfigurieren Sie dann die Request-URL in der Feishu-Konsole:
- Unter Events & Callbacks → Event Subscriptions wechseln Sie zu Push to URL
- Setzen Sie die URL auf
https://ihre-domain.de/feishu/events - Klicken Sie auf Verify — Feishu sendet eine Challenge-Anfrage, OpenClaw antwortet automatisch
⚠️ Der Webhook-Modus erfordert eine oeffentlich erreichbare URL. Sie benoetigen eine Domain, ein TLS-Zertifikat und passende Firewall-Regeln. Fuer die meisten Setups ist WebSocket deutlich einfacher.
Multi-Agent-Routing fuer Feishu mit OpenClaw
Wenn Sie mehrere KI-Agents betreiben, koennen Sie verschiedene Konversationen an verschiedene Agents weiterleiten:
{
bindings: [
{ agentId: "main", match: { channel: "feishu", peer: { kind: "direct" } } },
{ agentId: "support", match: { channel: "feishu", peer: { kind: "direct", id: "ou_xxxxx" } } },
{ agentId: "team-helper", match: { channel: "feishu", peer: { kind: "group", id: "oc_xxxxxxxxx" } } }
]
}
Standardmaessig werden Direktnachrichten an den main-Agent weitergeleitet. Bestimmte Benutzer oder Gruppen koennen gezielt an andere Agents geroutet werden, indem Sie die entsprechende peer.id angeben.
Das ist besonders nuetzlich fuer Organisationen, die einen Allzweck-Assistenten, einen Kundensupport-Agent und einen Entwickler-Agent betreiben moechten — alle ueber denselben Feishu-Bot, aber mit unterschiedlichen Modellen und Prompts.
Offizielles Feishu Plugin fuer OpenClaw
Das offizielle Feishu Plugin wird vom Feishu/Lark-Team bei ByteDance betreut. Im Gegensatz zum integrierten Plugin (das als Bot agiert) nutzt das offizielle Plugin OAuth, um im Namen eines Benutzers zu handeln. Das ermoeglicht vollen Workspace-Zugriff: Dokumente, Kalender, Aufgaben, Tabellen und Wikis.
Voraussetzungen
- OpenClaw ≥ 2026.2.26 (Linux/macOS) oder ≥ 2026.3.2 (Windows)
- Node.js ≥ 22
- npm im PATH verfuegbar
Installation
npm config set registry https://registry.npmjs.org curl -o /tmp/feishu-plugin.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz npm install /tmp/feishu-plugin.tgz -g rm /tmp/feishu-plugin.tgz feishu-plugin-onboard install
Der Befehl feishu-plugin-onboard install startet einen interaktiven Einrichtungsassistenten. Dieser wird:
- Nach Ihrer Feishu App ID und Ihrem App Secret fragen
- Ein Browserfenster fuer die OAuth-Autorisierung oeffnen
- Eine Konfigurationsdatei unter
~/.openclaw/plugins/feishu/config.jsonerstellen - Das Plugin bei Ihrer OpenClaw-Instanz registrieren
Nach der Installation
Ueberpruefen Sie nach der Installation, ob das Plugin geladen wurde:
openclaw plugins list
Sie sollten feishu-official in der Ausgabe sehen. Testen Sie es, indem Sie den Bot eine Workspace-Aktion ausfuehren lassen:
@Bot Fasse das neueste Dokument im Wiki-Bereich "Engineering" zusammen
Diagnose
Falls das Plugin nicht funktioniert:
feishu-plugin-onboard doctor # Haeufige Probleme pruefen feishu-plugin-onboard doctor --fix # Erkannte Probleme automatisch beheben feishu-plugin-onboard info --all # Vollstaendige Plugin-Informationen anzeigen
⚠️ Sicherheitshinweis: Das offizielle Plugin greift ueber Ihren persoenlichen OAuth-Token auf Ihre Workspace-Daten zu. Das bedeutet, der Bot kann jedes Dokument, jeden Kalendereintrag und jede Aufgabe lesen, auf die Sie Zugriff haben. Verwenden Sie das offizielle Plugin nicht auf gemeinsam genutzten Bots oder Rechnern — nutzen Sie es nur auf persoenlichen, abgesicherten Instanzen.
Beide Plugins gleichzeitig verwenden
Sie koennen das integrierte Plugin und das offizielle Plugin gleichzeitig betreiben. Das integrierte Plugin uebernimmt das Messaging, das offizielle Plugin die Workspace-Aktionen. OpenClaw leitet Anfragen automatisch an das passende Plugin weiter.
Um das offizielle Plugin zu deaktivieren, ohne es zu deinstallieren:
feishu-plugin-onboard disable
Fehlerbehebung bei Feishu-Integrationsproblemen
Kein Eingabefeld — Benutzer koennen dem Bot keine Nachrichten senden
Ursache: Event-Abonnements fehlen oder die App wurde nicht veroeffentlicht.
Loesung:
- Stellen Sie sicher, dass
im.message.receive_v1unter Events & Callbacks hinzugefuegt ist - Stellen Sie sicher, dass der Verbindungsmodus auf Long Connection gesetzt ist
- Stellen Sie sicher, dass die App veroeffentlicht ist (Version Management → aktive Version pruefen)
- Starten Sie das Gateway neu:
openclaw gateway restart
Fehler "App has not established a long connection"
Ursache: Das Feishu-Event-Abonnement erwartet eine WebSocket-Verbindung, aber OpenClaw hat sich noch nicht verbunden.
Loesung:
- Pruefen Sie, ob
connectionModein Ihrer Konfiguration auf"websocket"steht - Starten Sie das Gateway neu:
openclaw gateway restart - Pruefen Sie die Logs:
openclaw logs --follow— achten Sie auf WebSocket-Verbindungsmeldungen - Falls Sie sich hinter einem strikten Proxy befinden, pruefen Sie, ob ausgehende WebSocket-Verbindungen blockiert werden
Bot ist online, antwortet aber nicht auf Nachrichten
Ursache: In der Regel ein Pairing-Problem oder eine falsch konfigurierte DM-Richtlinie.
Loesung:
- Pruefen Sie, ob der Benutzer gekoppelt ist:
openclaw pairing list feishu - Bei Nutzung des
pairing-Modus den Benutzer genehmigen:openclaw pairing approve feishu <CODE> - Wenn jeder ohne Kopplung chatten soll, setzen Sie
dmPolicy: "open" - Pruefen Sie die Logs auf Fehler:
openclaw logs --follow
Bot antwortet nicht in Gruppenchats
Ursache: Der Bot erfordert eine @Erwaehnung, wurde aber nicht erwaehnt, oder die Gruppenrichtlinie blockiert die Gruppe.
Loesung:
- Stellen Sie sicher, dass
groupPolicyauf"open"steht oder die Gruppe in der Allowlist ist - Falls
requireMentionauf true steht, muessen Benutzer den Bot @erwaehnen - Ueberpruefen Sie, ob der Bot tatsaechlich Mitglied der Gruppe ist
- Stellen Sie sicher, dass die Berechtigung
im:message.group_msgaktiviert ist
Fehler "Message send failed" oder "send_as_bot"
Ursache: Die Berechtigung im:message:send_as_bot fehlt, oder die App wurde nach dem Hinzufuegen von Berechtigungen nicht neu veroeffentlicht.
Loesung:
- Stellen Sie sicher, dass die Berechtigung in der Entwicklerkonsole aktiviert ist
- Erstellen Sie eine neue Version und veroeffentlichen Sie diese — Berechtigungsaenderungen erfordern ein neues Release
- Starten Sie das Gateway neu
Konflikte zwischen integriertem und offiziellem Plugin
Ursache: Beide Plugins versuchen, dasselbe Event zu verarbeiten.
Loesung:
- In der Regel ist das unproblematisch — OpenClaw dedupliziert Events. Falls Sie doppelte Antworten sehen, deaktivieren Sie eines:
feishu-plugin-onboard disable # Offizielles Plugin deaktivieren # ODER openclaw channels disable feishu # Integriertes Plugin deaktivieren
- Pruefen Sie, welches Plugin Sie tatsaechlich benoetigen — die meisten Benutzer kommen mit dem integrierten Plugin aus
Windows: ENOENT-Fehler bei Installation des offiziellen Plugins
Ursache: npm kann die heruntergeladene .tgz-Datei nicht finden, meistens ein Pfadproblem unter Windows.
Loesung:
- Verwenden Sie einen vollstaendigen absoluten Pfad:
npm install C:\Users\IhrName\Downloads\feishu-plugin.tgz -g
- Stellen Sie sicher, dass Sie das Terminal als Administrator ausfuehren
- Ueberpruefen Sie Node.js ≥ 22:
node --version
OpenClaw Feishu Befehlsreferenz
| Befehl | Beschreibung |
|---|---|
openclaw channels add | Interaktive Kanal-Einrichtung |
openclaw channels disable feishu | Feishu-Kanal deaktivieren |
openclaw channels enable feishu | Feishu-Kanal wieder aktivieren |
openclaw gateway | Gateway starten |
openclaw gateway restart | Gateway neu starten |
openclaw gateway status | Verbindungsstatus pruefen |
openclaw pairing list feishu | Gekoppelte Feishu-Benutzer anzeigen |
openclaw pairing approve feishu <CODE> | Kopplungsanfrage genehmigen |
openclaw pairing revoke feishu <USER> | Benutzerzugriff widerrufen |
openclaw logs --follow | Gateway-Logs streamen |
feishu-plugin-onboard install | Offizielles Plugin installieren |
feishu-plugin-onboard doctor | Probleme des offiziellen Plugins diagnostizieren |
feishu-plugin-onboard doctor --fix | Erkannte Probleme automatisch beheben |
feishu-plugin-onboard info --all | Vollstaendige Plugin-Informationen anzeigen |
FAQ
Brauche ich eine oeffentliche IP oder Domain fuer den Feishu-Bot?
Nein. Der WebSocket-Modus (Standard) stellt eine ausgehende Verbindung von Ihrem Rechner zu den Feishu-Servern her. Kein eingehender Datenverkehr, keine Portweiterleitung, keine DNS-Eintraege. Die einzige Ausnahme ist der Webhook-Modus, der eine oeffentlich erreichbare URL erfordert.
Was ist der Unterschied zwischen Feishu und Lark?
Feishu ist fuer den chinesischen Markt. Lark ist die internationale Version. Sie laufen auf getrennter Infrastruktur, haben aber dieselben Funktionen und APIs. Der einzige Konfigurationsunterschied ist das Feld domain — setzen Sie es auf "feishu" oder "lark". Ihre App ID und Ihr Secret funktionieren auf der Plattform, auf der Sie sie erstellt haben.
Sollte ich das integrierte oder das offizielle Feishu Plugin verwenden?
Fuer Messaging — Nachrichten senden und empfangen, im Chat geteilte Inhalte lesen — reicht das integrierte Plugin voellig aus. Fuer Workspace-Aktionen — Dokumente lesen, Kalender verwalten, Aufgaben erstellen, Tabellen abfragen — verwenden Sie das offizielle Plugin. Beide koennen gleichzeitig betrieben werden.
Kann ich Feishu neben anderen OpenClaw-Kanaelen betreiben?
Ja. OpenClaw unterstuetzt mehrere Kanaele gleichzeitig. Sie koennen Feishu, Telegram, Discord, WhatsApp und weitere parallel laufen lassen, jeweils verbunden mit denselben oder unterschiedlichen Agents. Fuegen Sie weitere Kanaele mit openclaw channels add hinzu.
Die Antworten sind langsam — wie kann ich die OpenClaw Feishu-Performance verbessern?
- Streaming aktivieren (
streaming: true) — so werden Teilantworten angezeigt, waehrend sie generiert werden, und Benutzer sehen sofort Text erscheinen - Modell ueberpruefen — groessere Modelle sind langsamer. Probieren Sie ein schnelleres Modell fuer Routineanfragen
- Netzwerk-Latenz pruefen — wenn Ihre OpenClaw-Instanz weit von den Feishu-Servern entfernt ist, fuehlen sich Antworten langsamer an
- Prompt ueberpruefen — lange System-Prompts erhoehen die Verarbeitungszeit
Mein App Secret wurde kompromittiert — was soll ich tun?
- Gehen Sie sofort zur Feishu-Entwicklerkonsole
- Navigieren Sie zu Credentials & Basic Info
- Klicken Sie neben App Secret auf Reset
- Kopieren Sie das neue Secret
- Aktualisieren Sie
~/.openclaw/openclaw.jsonmit dem neuen Wert - Starten Sie das Gateway neu:
openclaw gateway restart - Das alte Secret wird sofort ungueltig — Sie muessen keine einzelnen Sitzungen widerrufen
Naechste Schritte nach der Feishu-Einrichtung
Nachdem Ihre Feishu/Lark-Integration laeuft, entdecken Sie, was OpenClaw noch alles kann:
- Alle 50+ unterstuetzten Kanaele durchsuchen — weitere Plattformen anbinden
- Skills-Verzeichnis — entdecken Sie, was Ihr KI-Assistent alles kann
- Fehlerbehebungs-Anleitung — haeufige Probleme kanaeluebergreifend loesen
- Vollstaendige Einsteiger-Anleitung — OpenClaw von Grund auf lernen
- Telegram-Integration — Telegram als weiteren Kanal einrichten
- Discord-Integration — Discord mit Gateway Intents aufsetzen