OpenClaw
Integrationen18 Min. Lesezeit

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.

O

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 vonOpenClaw CommunityFeishu/Lark Team (ByteDance)
IdentitaetBotBenutzer-Proxy (OAuth)
FunktionsumfangMessaging, einfaches Lesen von DokumentenVoller Workspace-Zugriff: Dokumente, Kalender, Aufgaben, Tabellen, Wiki
InstallationIntegriert, keine Zusatzinstallationfeishu-plugin-onboard install
KomplexitaetMittelHoeher
Geeignet fuerSchnelles Messaging-SetupTeams 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:

bash
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:

Anwendung erstellen

  1. Klicken Sie auf Create Custom App (oder "Enterprise Self-Built Application", je nach Oberflaeche)
  2. Geben Sie einen aussagekraeftigen App-Namen ein, z. B. "OpenClaw Assistant"
  3. Optional: Fuegen Sie ein Icon und eine Beschreibung hinzu — das ist das, was Benutzer im Bot-Verzeichnis sehen

Zugangsdaten kopieren

  1. Gehen Sie zu Credentials & Basic Info in der linken Seitenleiste
  2. Kopieren Sie die App ID (sieht aus wie cli_a5xxxxxxxxxxxxx)
  3. 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.

  1. Gehen Sie in den App-Einstellungen zu Development Settings → Permission Management
  2. Klicken Sie auf Batch Enable (oder "Batch Import Scopes")
  3. Fuegen Sie folgenden JSON-Block ein:
json
{
  "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"
    ]
  }
}
  1. 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 empfangen
  • im:message:send_as_bot — Nachrichten als Bot senden
  • im:message.p2p_msg:readonly — Direktnachrichten lesen
  • im:message.group_at_msg:readonly — @Erwaehnung-Nachrichten in Gruppen lesen
  • im:message.group_msg — Alle Gruppennachrichten lesen
  • im:resource — Auf Nachrichtenressourcen zugreifen (Bilder, Dateien)
  • im:chat — Chat-Metadaten abrufen
  • im:chat.members:bot_access — Bot-Mitgliedschaft in Chats pruefen
  • contact:user.employee_id:readonly — Benutzer-IDs lesen
  • docs: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

  1. Gehen Sie in der linken Seitenleiste zu App Capabilities → Bot
  2. Schalten Sie die Bot-Funktion ein
  3. 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.

  1. Gehen Sie zu Events & Callbacks → Event Subscriptions
  2. Waehlen Sie als Connection Mode die Option Long Connection (WebSocket)
  3. Fuegen Sie folgende Events hinzu:
EventNameErforderlich?
im.message.receive_v1Nachrichten empfangenJa
im.message.reaction.created_v1Emoji-Reaktion hinzugefuegtOptional
im.message.reaction.deleted_v1Emoji-Reaktion entferntOptional
application.bot.menu_v6Benutzerdefiniertes Bot-MenueOptional

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.

  1. Gehen Sie zu Version Management in der linken Seitenleiste
  2. Klicken Sie auf Create Version
  3. Geben Sie eine Versionsnummer ein (z. B. 1.0.0) und fuegen Sie Release Notes hinzu
  4. 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:

  1. Oeffnen Sie Feishu (oder Lark) auf Desktop oder Mobilgeraet
  2. Gehen Sie zum App-Verzeichnis oder zur Suchleiste
  3. Suchen Sie nach Ihrem App-Namen
  4. 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:

bash
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:

json5
{
  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

OptionStandardBeschreibung
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
requireMentiontrueOb eine @Erwaehnung noetig ist, um den Bot in Gruppen auszuloesen
streamingtrueStreaming-Ausgabe aktivieren (Schreibmaschinen-Effekt)
typingIndicatortrue"Tippt..."-Anzeige waehrend der Generierung anzeigen
textChunkLimit2000Maximale Zeichen pro Nachrichtenblock
mediaMaxMb30Maximale 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

bash
openclaw gateway           # Gateway starten (Vordergrund)

In einem separaten Terminal koennen Sie die Logs verfolgen:

bash
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.

  1. Oeffnen Sie Feishu (oder Lark) und suchen Sie Ihren Bot
  2. Senden Sie eine beliebige Nachricht — "Hallo" reicht voellig aus
  3. Pruefen Sie Ihr Terminal. Sie sehen eine Kopplungsanfrage mit einem Code:
[feishu] New pairing request from user_xxxxx (Code: ABC123)
  1. Genehmigen Sie die Kopplung:
bash
openclaw pairing approve feishu ABC123
  1. Gehen Sie zurueck zu Feishu/Lark und senden Sie eine weitere Nachricht
  2. Die KI sollte nun antworten

Verbindung ueberpruefen

bash
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:

json5
{
  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: true global 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:

json5
{
  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:

  1. Gehen Sie in den Feishu-App-Einstellungen zu Events & Callbacks → Encryption Strategy
  2. Kopieren Sie Verification Token und Encrypt Key

Konfigurieren Sie dann die Request-URL in der Feishu-Konsole:

  1. Unter Events & Callbacks → Event Subscriptions wechseln Sie zu Push to URL
  2. Setzen Sie die URL auf https://ihre-domain.de/feishu/events
  3. 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:

json5
{
  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

bash
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:

  1. Nach Ihrer Feishu App ID und Ihrem App Secret fragen
  2. Ein Browserfenster fuer die OAuth-Autorisierung oeffnen
  3. Eine Konfigurationsdatei unter ~/.openclaw/plugins/feishu/config.json erstellen
  4. Das Plugin bei Ihrer OpenClaw-Instanz registrieren

Nach der Installation

Ueberpruefen Sie nach der Installation, ob das Plugin geladen wurde:

bash
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:

bash
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:

bash
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:

  1. Stellen Sie sicher, dass im.message.receive_v1 unter Events & Callbacks hinzugefuegt ist
  2. Stellen Sie sicher, dass der Verbindungsmodus auf Long Connection gesetzt ist
  3. Stellen Sie sicher, dass die App veroeffentlicht ist (Version Management → aktive Version pruefen)
  4. 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:

  1. Pruefen Sie, ob connectionMode in Ihrer Konfiguration auf "websocket" steht
  2. Starten Sie das Gateway neu: openclaw gateway restart
  3. Pruefen Sie die Logs: openclaw logs --follow — achten Sie auf WebSocket-Verbindungsmeldungen
  4. 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:

  1. Pruefen Sie, ob der Benutzer gekoppelt ist: openclaw pairing list feishu
  2. Bei Nutzung des pairing-Modus den Benutzer genehmigen: openclaw pairing approve feishu <CODE>
  3. Wenn jeder ohne Kopplung chatten soll, setzen Sie dmPolicy: "open"
  4. 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:

  1. Stellen Sie sicher, dass groupPolicy auf "open" steht oder die Gruppe in der Allowlist ist
  2. Falls requireMention auf true steht, muessen Benutzer den Bot @erwaehnen
  3. Ueberpruefen Sie, ob der Bot tatsaechlich Mitglied der Gruppe ist
  4. Stellen Sie sicher, dass die Berechtigung im:message.group_msg aktiviert 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:

  1. Stellen Sie sicher, dass die Berechtigung in der Entwicklerkonsole aktiviert ist
  2. Erstellen Sie eine neue Version und veroeffentlichen Sie diese — Berechtigungsaenderungen erfordern ein neues Release
  3. Starten Sie das Gateway neu

Konflikte zwischen integriertem und offiziellem Plugin

Ursache: Beide Plugins versuchen, dasselbe Event zu verarbeiten.

Loesung:

  1. In der Regel ist das unproblematisch — OpenClaw dedupliziert Events. Falls Sie doppelte Antworten sehen, deaktivieren Sie eines:
bash
feishu-plugin-onboard disable    # Offizielles Plugin deaktivieren
# ODER
openclaw channels disable feishu  # Integriertes Plugin deaktivieren
  1. 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:

  1. Verwenden Sie einen vollstaendigen absoluten Pfad:
bash
npm install C:\Users\IhrName\Downloads\feishu-plugin.tgz -g
  1. Stellen Sie sicher, dass Sie das Terminal als Administrator ausfuehren
  2. Ueberpruefen Sie Node.js ≥ 22: node --version

OpenClaw Feishu Befehlsreferenz

BefehlBeschreibung
openclaw channels addInteraktive Kanal-Einrichtung
openclaw channels disable feishuFeishu-Kanal deaktivieren
openclaw channels enable feishuFeishu-Kanal wieder aktivieren
openclaw gatewayGateway starten
openclaw gateway restartGateway neu starten
openclaw gateway statusVerbindungsstatus pruefen
openclaw pairing list feishuGekoppelte Feishu-Benutzer anzeigen
openclaw pairing approve feishu <CODE>Kopplungsanfrage genehmigen
openclaw pairing revoke feishu <USER>Benutzerzugriff widerrufen
openclaw logs --followGateway-Logs streamen
feishu-plugin-onboard installOffizielles Plugin installieren
feishu-plugin-onboard doctorProbleme des offiziellen Plugins diagnostizieren
feishu-plugin-onboard doctor --fixErkannte Probleme automatisch beheben
feishu-plugin-onboard info --allVollstaendige 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?

  1. Streaming aktivieren (streaming: true) — so werden Teilantworten angezeigt, waehrend sie generiert werden, und Benutzer sehen sofort Text erscheinen
  2. Modell ueberpruefen — groessere Modelle sind langsamer. Probieren Sie ein schnelleres Modell fuer Routineanfragen
  3. Netzwerk-Latenz pruefen — wenn Ihre OpenClaw-Instanz weit von den Feishu-Servern entfernt ist, fuehlen sich Antworten langsamer an
  4. Prompt ueberpruefen — lange System-Prompts erhoehen die Verarbeitungszeit

Mein App Secret wurde kompromittiert — was soll ich tun?

  1. Gehen Sie sofort zur Feishu-Entwicklerkonsole
  2. Navigieren Sie zu Credentials & Basic Info
  3. Klicken Sie neben App Secret auf Reset
  4. Kopieren Sie das neue Secret
  5. Aktualisieren Sie ~/.openclaw/openclaw.json mit dem neuen Wert
  6. Starten Sie das Gateway neu: openclaw gateway restart
  7. 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: