OpenClaw Feishu / Lark Kanal
Verbinden Sie OpenClaw mit Feishu (飞书) oder Lark über WebSocket-basierte Event-Subscription. Diese Enterprise-Integration ermöglicht es Ihrem KI-Assistenten, Direktnachrichten und Gruppenchats auf Feishu/Lark zu verarbeiten — ByteDances führender Unternehmens-Kollaborationsplattform. OpenClaw verbindet sich über den Long-Connection-Modus (WebSocket) der Feishu Open Platform, sodass keine öffentliche URL oder kein Webhook-Endpunkt erforderlich ist.
Feishu / Lark Unterstützte Funktionen
Textnachrichten
Unterstützt
Medien & Dateien
Unterstützt
Reaktionen
Nicht unterstützt
Threads
Nicht unterstützt
Sprachnachrichten
Nicht unterstützt
Gruppenchat
Unterstützt
Feishu / Lark Voraussetzungen
- Ein Feishu- (feishu.cn) oder Lark-Tenant-Konto (larksuite.com) mit App-Erstellungsrechten
- Das Feishu-Plugin installiert: openclaw plugins install @openclaw/feishu
- OpenClaw Gateway läuft und ist konfiguriert
- Node.js 18+ auf Ihrem Server installiert
Feishu / Lark Schnelleinrichtung
Feishu/Lark-App erstellen
Besuchen Sie die Feishu Open Platform (open.feishu.cn/app) oder die Lark Developer Console (open.larksuite.com/app). Erstellen Sie eine neue Enterprise-App, legen Sie Name, Beschreibung und Icon fest. Kopieren Sie die App ID (Format: cli_xxx) und das App Secret von der Anmeldedaten-Seite.
Berechtigungen und Bot-Fähigkeit konfigurieren
Importieren Sie in der Berechtigungsverwaltung der App die erforderlichen Berechtigungen im Batch. Aktivieren Sie die Bot-Fähigkeit unter App-Fähigkeiten > Bot. Wählen Sie in der Event-Subscription 'Long Connection verwenden' (WebSocket-Modus) und fügen Sie das Event im.message.receive_v1 hinzu. Veröffentlichen Sie die App über Versionsverwaltung und Freigabe.
Feishu-Kanal-Konfiguration zu OpenClaw hinzufügen
Führen Sie 'openclaw channels add' aus und wählen Sie Feishu, oder fügen Sie die Kanalkonfiguration manuell in ~/.openclaw/openclaw.json mit appId und appSecret hinzu. Sie können auch die Umgebungsvariablen FEISHU_APP_ID und FEISHU_APP_SECRET verwenden.
Gateway starten und testen
Führen Sie 'openclaw gateway' aus, um den Dienst zu starten. Senden Sie eine Direktnachricht an den Bot in Feishu. Bei Verwendung der Standard-Pairing-Richtlinie genehmigen Sie den Absender über 'openclaw pairing approve feishu <code>' im Terminal.
Feishu / Lark Konfigurationsbeispiel
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET",
"botName": "My AI Assistant"
}
}
}
}
}Feishu / Lark Detaillierte Dokumentation
Architekturübersicht
Feishu-App-Erstellung und Anmeldedaten
# Über Umgebungsvariablen
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="your_app_secret"
# Oder über CLI-Assistent
openclaw channels addFeishu vs. Lark Konfiguration
{
"channels": {
"feishu": {
"domain": "lark",
"accounts": {
"main": {
"appId": "cli_xxx",
"appSecret": "YOUR_APP_SECRET"
}
}
}
}
}DM-Richtlinien
{
"channels": {
"feishu": {
"dmPolicy": "allowlist",
"allowFrom": ["ou_xxx", "ou_yyy"]
}
}
}Gruppenchat-Verwaltung
{
"channels": {
"feishu": {
"groupPolicy": "open",
"requireMention": true
}
}
}Streaming-Antworten (Interaktive Karten)
{
"channels": {
"feishu": {
"streaming": true
}
}
}Nachrichtentypen und Medienunterstützung
{
"channels": {
"feishu": {
"mediaMaxMb": 30,
"textChunkLimit": 2000
}
}
}Multi-Account und Multi-Agent-Routing
{
"channels": {
"feishu": {
"accounts": {
"support": {
"appId": "cli_aaa",
"appSecret": "secret_a",
"botName": "Support Bot"
},
"hr": {
"appId": "cli_bbb",
"appSecret": "secret_b",
"botName": "HR Bot"
}
}
}
}
}Nützliche Befehle
Feishu / Lark Konfigurationsreferenz
| Key | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Feishu-Kanal aktivieren oder deaktivieren |
| domain | string | "feishu" | API-Domain: 'feishu' für Inland (feishu.cn) oder 'lark' für international (larksuite.com) |
| dmPolicy | string | "pairing" | Steuert, wer dem Bot DMs senden kann. Optionen: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | Open IDs (ou_xxx), die dem Bot DMs senden dürfen, wenn dmPolicy 'allowlist' ist |
| groupPolicy | string | "open" | Gruppenchat-Richtlinie. Optionen: open, allowlist, disabled |
| requireMention | boolean | true | Ob der Bot eine @Erwähnung in Gruppenchats erfordert |
| streaming | boolean | true | Streaming-KI-Antworten über interaktive Karten aktivieren |
| textChunkLimit | number | 2000 | Maximale Zeichen pro Textnachricht |
| mediaMaxMb | number | 30 | Maximale Mediendateigröße in Megabyte |
| accounts.<id>.appId | string | "" | Feishu App ID (Format: cli_xxx) |
| accounts.<id>.appSecret | string | "" | Feishu App Secret |
| accounts.<id>.botName | string | "" | Anzeigename des Bots in Feishu-Chats |
| historyLimit | number | 50 | Anzahl der letzten Nachrichten als KI-Kontext |
Feishu-Kanal aktivieren oder deaktivieren
API-Domain: 'feishu' für Inland (feishu.cn) oder 'lark' für international (larksuite.com)
Steuert, wer dem Bot DMs senden kann. Optionen: pairing, allowlist, open, disabled
Open IDs (ou_xxx), die dem Bot DMs senden dürfen, wenn dmPolicy 'allowlist' ist
Gruppenchat-Richtlinie. Optionen: open, allowlist, disabled
Ob der Bot eine @Erwähnung in Gruppenchats erfordert
Streaming-KI-Antworten über interaktive Karten aktivieren
Maximale Zeichen pro Textnachricht
Maximale Mediendateigröße in Megabyte
Feishu App ID (Format: cli_xxx)
Feishu App Secret
Anzeigename des Bots in Feishu-Chats
Anzahl der letzten Nachrichten als KI-Kontext
Feishu / Lark Häufig gestellte Fragen
Feishu / Lark Fehlerbehebung
Bot ist möglicherweise nicht zur Gruppe hinzugefügt, @Erwähnung funktioniert nicht, oder groupPolicy ist 'disabled'.
App ist möglicherweise nicht veröffentlicht, Event-Subscription nicht konfiguriert, oder Berechtigungen fehlen.
Die Berechtigung im:message:send_as_bot wurde möglicherweise nicht erteilt.
App Secret wurde versehentlich in die Versionskontrolle committed.
Netzwerkinstabilität oder Firewall stört WebSocket-Verbindungen.