Feishu

Feishu/Lark ist eine All-in-one-Kollaborationsplattform, auf der Teams chatten, Dokumente teilen, Kalender verwalten und gemeinsam Arbeit erledigen.

Status: produktionsreif für Bot-Direktnachrichten + Gruppenchats. WebSocket ist der Standardmodus; der Webhook-Modus ist optional.

Schnellstart

openclaw channels login --channel feishu

openclaw gateway restart

Zugriffskontrolle

Direktnachrichten

Konfigurieren Sie dmPolicy, um zu steuern, wer dem Bot eine Direktnachricht senden kann:

• "pairing" - unbekannte Benutzer erhalten einen Kopplungscode; Genehmigung über die CLI
• "allowlist" - nur in allowFrom aufgeführte Benutzer können chatten (Standard: nur Bot-Besitzer)
• "open" - öffentliche Direktnachrichten nur zulassen, wenn allowFrom "*" enthält; bei restriktiven Einträgen können nur passende Benutzer chatten
• "disabled" - alle Direktnachrichten deaktivieren

Kopplungsanfrage genehmigen:

openclaw pairing list feishuopenclaw pairing approve feishu <CODE>

Gruppenchats

Gruppenrichtlinie (channels.feishu.groupPolicy):

Standard: allowlist

Erwähnungspflicht (channels.feishu.requireMention):

• true - @Erwähnung erforderlich (Standard)
• false - ohne @Erwähnung antworten
• Überschreibung pro Gruppe: channels.feishu.groups.<chat_id>.requireMention
• Reine Broadcast-Erwähnungen @all und @_all werden nicht als Bot-Erwähnungen behandelt. Eine Nachricht, die sowohl @all als auch den Bot direkt erwähnt, zählt weiterhin als Bot-Erwähnung.

Beispiele für Gruppenkonfiguration

Alle Gruppen zulassen, keine @Erwähnung erforderlich

{  channels: {    feishu: {      groupPolicy: "open",    },  },}

Alle Gruppen zulassen, @Erwähnung weiterhin erforderlich

{  channels: {    feishu: {      groupPolicy: "open",      requireMention: true,    },  },}

Nur bestimmte Gruppen zulassen

{  channels: {    feishu: {      groupPolicy: "allowlist",      // Group IDs look like: oc_xxx      groupAllowFrom: ["oc_xxx", "oc_yyy"],    },  },}

Im Modus allowlist können Sie eine Gruppe auch zulassen, indem Sie einen expliziten groups.<chat_id>-Eintrag hinzufügen. Explizite Einträge überschreiben groupPolicy: "disabled" nicht. Wildcard-Standards unter groups.* konfigurieren passende Gruppen, lassen Gruppen aber nicht von sich aus zu.

{  channels: {    feishu: {      groupPolicy: "allowlist",      groups: {        oc_xxx: {          requireMention: false,        },      },    },  },}

Absender innerhalb einer Gruppe einschränken

{  channels: {    feishu: {      groupPolicy: "allowlist",      groupAllowFrom: ["oc_xxx"],      groups: {        oc_xxx: {          // User open_ids look like: ou_xxx          allowFrom: ["ou_user1", "ou_user2"],        },      },    },  },}

Gruppen-/Benutzer-IDs abrufen

Gruppen-IDs (chat_id, Format: oc_xxx)

Öffnen Sie die Gruppe in Feishu/Lark, klicken Sie oben rechts auf das Menüsymbol und gehen Sie zu Einstellungen. Die Gruppen-ID (chat_id) wird auf der Einstellungsseite aufgeführt.

Benutzer-IDs (open_id, Format: ou_xxx)

Starten Sie den Gateway, senden Sie dem Bot eine Direktnachricht und prüfen Sie dann die Logs:

openclaw logs --follow

Suchen Sie in der Logausgabe nach open_id. Sie können auch ausstehende Kopplungsanfragen prüfen:

openclaw pairing list feishu

Häufige Befehle

Fehlerbehebung

Bot antwortet nicht in Gruppenchats

1. Stellen Sie sicher, dass der Bot der Gruppe hinzugefügt wurde
2. Stellen Sie sicher, dass Sie den Bot @erwähnen (standardmäßig erforderlich)
3. Prüfen Sie, dass groupPolicy nicht "disabled" ist
4. Logs prüfen: openclaw logs --follow

Bot empfängt keine Nachrichten

1. Stellen Sie sicher, dass der Bot in Feishu Open Platform / Lark Developer veröffentlicht und genehmigt ist
2. Stellen Sie sicher, dass das Ereignisabonnement im.message.receive_v1 enthält
3. Stellen Sie sicher, dass persistente Verbindung (WebSocket) ausgewählt ist
4. Stellen Sie sicher, dass alle erforderlichen Berechtigungsbereiche gewährt sind
5. Stellen Sie sicher, dass der Gateway läuft: openclaw gateway status
6. Logs prüfen: openclaw logs --follow

QR-Einrichtung reagiert in der Feishu-Mobile-App nicht

1. Einrichtung erneut ausführen: openclaw channels login --channel feishu
2. Manuelle Einrichtung wählen
3. Erstellen Sie in der Feishu Open Platform eine selbst erstellte App und kopieren Sie ihre App ID und ihr App Secret
4. Fügen Sie diese Zugangsdaten in den Einrichtungsassistenten ein

App Secret offengelegt

1. Setzen Sie das App Secret in Feishu Open Platform / Lark Developer zurück
2. Aktualisieren Sie den Wert in Ihrer Konfiguration
3. Gateway neu starten: openclaw gateway restart

Erweiterte Konfiguration

Mehrere Konten

{  channels: {    feishu: {      defaultAccount: "main",      accounts: {        main: {          appId: "cli_xxx",          appSecret: "xxx",          name: "Primary bot",          tts: {            providers: {              openai: { voice: "shimmer" },            },          },        },        backup: {          appId: "cli_yyy",          appSecret: "yyy",          name: "Backup bot",          enabled: false,        },      },    },  },}

defaultAccount steuert, welches Konto verwendet wird, wenn ausgehende APIs keine accountId angeben. accounts.<id>.tts verwendet dieselbe Struktur wie messages.tts und führt einen Deep-Merge über die globale TTS-Konfiguration aus. Dadurch können Feishu-Setups mit mehreren Bots gemeinsame Provider- Zugangsdaten global halten und pro Konto nur Stimme, Modell, Persona oder Automodus überschreiben.

Nachrichtenlimits

• textChunkLimit - Größe ausgehender Textblöcke (Standard: 2000 Zeichen)
• mediaMaxMb - Limit für Medien-Uploads/-Downloads (Standard: 30 MB)

Streaming

Feishu/Lark unterstützt Streaming-Antworten über interaktive Karten. Wenn aktiviert, aktualisiert der Bot die Karte in Echtzeit, während er Text generiert.

{  channels: {    feishu: {      streaming: true, // enable streaming card output (default: true)      blockStreaming: true, // opt into completed-block streaming    },  },}

Setzen Sie streaming: false, um die vollständige Antwort in einer Nachricht zu senden. blockStreaming ist standardmäßig deaktiviert; aktivieren Sie es nur, wenn abgeschlossene Assistentenblöcke vor der finalen Antwort ausgegeben werden sollen.

Quotenoptimierung

Reduzieren Sie die Anzahl der Feishu/Lark-API-Aufrufe mit zwei optionalen Flags:

• typingIndicator (Standard true): auf false setzen, um Aufrufe für Tippreaktionen zu überspringen
• resolveSenderNames (Standard true): auf false setzen, um Abfragen von Absenderprofilen zu überspringen

{  channels: {    feishu: {      typingIndicator: false,      resolveSenderNames: false,    },  },}

ACP-Sitzungen

Feishu/Lark unterstützt ACP für Direktnachrichten und Gruppen-Thread-Nachrichten. Feishu/Lark-ACP ist textbefehlsbasiert - es gibt keine nativen Slash-Command-Menüs, verwenden Sie daher /acp ...-Nachrichten direkt in der Unterhaltung.

Persistente ACP-Bindung

{  agents: {    list: [      {        id: "codex",        runtime: {          type: "acp",          acp: {            agent: "codex",            backend: "acpx",            mode: "persistent",            cwd: "/workspace/openclaw",          },        },      },    ],  },  bindings: [    {      type: "acp",      agentId: "codex",      match: {        channel: "feishu",        accountId: "default",        peer: { kind: "direct", id: "ou_1234567890" },      },    },    {      type: "acp",      agentId: "codex",      match: {        channel: "feishu",        accountId: "default",        peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },      },      acp: { label: "codex-feishu-topic" },    },  ],}

ACP aus Chat starten

In einer Feishu/Lark-Direktnachricht oder einem Thread:

/acp spawn codex --thread here

--thread here funktioniert für Direktnachrichten und Feishu/Lark-Thread-Nachrichten. Folgenachrichten in der gebundenen Unterhaltung werden direkt an diese ACP-Sitzung weitergeleitet.

Routing für mehrere Agenten

Verwenden Sie bindings, um Feishu/Lark-Direktnachrichten oder Gruppen an verschiedene Agenten weiterzuleiten.

{  agents: {    list: [      { id: "main" },      { id: "agent-a", workspace: "/home/user/agent-a" },      { id: "agent-b", workspace: "/home/user/agent-b" },    ],  },  bindings: [    {      agentId: "agent-a",      match: {        channel: "feishu",        peer: { kind: "direct", id: "ou_xxx" },      },    },    {      agentId: "agent-b",      match: {        channel: "feishu",        peer: { kind: "group", id: "oc_zzz" },      },    },  ],}

Routing-Felder:

• match.channel: "feishu"
• match.peer.kind: "direct" (Direktnachricht) oder "group" (Gruppenchat)
• match.peer.id: Benutzer-Open-ID (ou_xxx) oder Gruppen-ID (oc_xxx)

Siehe Gruppen-/Benutzer-IDs abrufen für Tipps zum Nachschlagen.

Konfigurationsreferenz

Vollständige Konfiguration: Gateway-Konfiguration

Unterstützte Nachrichtentypen

Empfangen

• ✅ Text
• ✅ Rich Text (Post)
• ✅ Bilder
• ✅ Dateien
• ✅ Audio
• ✅ Video/Medien
• ✅ Sticker

Eingehende Feishu/Lark-Audionachrichten werden als Medienplatzhalter normalisiert statt als rohes file_key-JSON. Wenn tools.media.audio konfiguriert ist, lädt OpenClaw die Sprachnotiz-Ressource herunter und führt vor dem Agent-Turn die gemeinsame Audiotranskription aus, sodass der Agent das gesprochene Transkript erhält. Wenn Feishu Transkripttext direkt in der Audio-Payload enthält, wird dieser Text ohne einen weiteren ASR-Aufruf verwendet. Ohne Provider für Audiotranskription erhält der Agent weiterhin einen <media:audio>-Platzhalter plus den gespeicherten Anhang, nicht die rohe Feishu-Ressourcen-Payload.

Senden

• ✅ Text
• ✅ Bilder
• ✅ Dateien
• ✅ Audio
• ✅ Video/Medien
• ✅ Interaktive Karten (einschließlich Streaming-Updates)
• ⚠️ Rich Text (Post-Formatierung; unterstützt nicht den vollständigen Funktionsumfang zur Feishu/Lark-Erstellung)

Native Feishu/Lark-Audioblasen verwenden den Feishu-Nachrichtentyp audio und erfordern Ogg/Opus-Upload-Medien (file_type: "opus"). Vorhandene .opus- und .ogg-Medien werden direkt als natives Audio gesendet. MP3/WAV/M4A und andere wahrscheinliche Audioformate werden nur dann mit ffmpeg in 48-kHz-Ogg/Opus transkodiert, wenn die Antwort eine Sprachausgabe anfordert (audioAsVoice / Nachrichten-Tool asVoice, einschließlich TTS-Sprachnotizantworten). Gewöhnliche MP3-Anhänge bleiben reguläre Dateien. Wenn ffmpeg fehlt oder die Konvertierung fehlschlägt, fällt OpenClaw auf einen Dateianhang zurück und protokolliert den Grund.

Threads und Antworten

• ✅ Inline-Antworten
• ✅ Thread-Antworten
• ✅ Medienantworten bleiben Thread-bewusst, wenn auf eine Thread-Nachricht geantwortet wird

Für groupSessionScope: "group_topic" und "group_topic_sender" verwenden native Feishu/Lark-Themengruppen die Event-thread_id (omt_*) als kanonischen Themensitzungsschlüssel. Wenn ein natives Themenstarter-Event thread_id auslässt, reichert OpenClaw sie aus Feishu an, bevor der Turn geroutet wird. Normale Gruppenantworten, die OpenClaw in Threads umwandelt, verwenden weiterhin die Nachrichten-ID der Antwortwurzel (om_*), damit der erste Turn und der Folge-Turn in derselben Sitzung bleiben.

Verwandte Themen

• Kanalübersicht - alle unterstützten Kanäle
• Kopplung - DM-Authentifizierung und Kopplungsablauf
• Gruppen - Gruppenchatverhalten und Mention-Gating
• Kanal-Routing - Sitzungsrouting für Nachrichten
• Sicherheit - Zugriffsmodell und Härtung