Feishu / Lark

Feishu/Lark ist eine All-in-one-Kollaborationsplattform, auf der Teams chatten, Dokumente teilen, Kalender verwalten und gemeinsam arbeiten. Status: produktionsbereit für Bot-DMs und Gruppenchats. WebSocket ist der Standardmodus; der Webhook-Modus ist optional.

Schnellstart

Erfordert OpenClaw 2026.4.10 oder höher. Führen Sie openclaw --version aus, um die Version zu prüfen. Aktualisieren Sie mit openclaw update.

Führen Sie den Einrichtungsassistenten für den Kanal aus

openclaw channels login --channel feishu

Scannen Sie den QR-Code mit Ihrer Feishu-/Lark-Mobil-App, um automatisch einen Feishu-/Lark-Bot zu erstellen.

Nachdem die Einrichtung abgeschlossen ist, starten Sie das Gateway neu, um die Änderungen anzuwenden

openclaw gateway restart

Zugriffskontrolle

Direktnachrichten

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

"pairing" — unbekannte Benutzer erhalten einen Pairing-Code; Freigabe über die CLI
"allowlist" — nur Benutzer, die in allowFrom aufgeführt sind, können chatten (Standard: nur der Bot-Eigentümer)
"open" — alle Benutzer zulassen
"disabled" — alle Direktnachrichten deaktivieren

Eine Pairing-Anfrage freigeben:

openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Gruppenchats

Gruppenrichtlinie (channels.feishu.groupPolicy):

Value	Verhalten
`"open"`	Auf alle Nachrichten in Gruppen antworten
`"allowlist"`	Nur auf Gruppen in `groupAllowFrom` antworten
`"disabled"`	Alle Gruppennachrichten deaktivieren

Standard: allowlist Erforderliche Erwähnung (channels.feishu.requireMention):

true — @Erwähnung erforderlich (Standard)
false — ohne @Erwähnung antworten
Pro-Gruppe-Überschreibung: channels.feishu.groups.<chat_id>.requireMention

Beispiele für die Gruppenkonfiguration

Alle Gruppen zulassen, keine @Erwähnung erforderlich

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

Alle Gruppen zulassen, aber weiterhin @Erwähnung erforderlich

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

Nur bestimmte Gruppen zulassen

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      // Gruppen-IDs sehen so aus: oc_xxx
      groupAllowFrom: ["oc_xxx", "oc_yyy"],
    },
  },
}

Absender innerhalb einer Gruppe einschränken

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["oc_xxx"],
      groups: {
        oc_xxx: {
          // Benutzer-open_ids sehen so aus: 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 auf das Menüsymbol oben rechts und gehen Sie zu Settings. Die Gruppen-ID (chat_id) wird auf der Einstellungsseite angezeigt.

Benutzer-IDs (`open_id`, Format: `ou_xxx`)

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

openclaw logs --follow

Suchen Sie in der Protokollausgabe nach open_id. Sie können auch ausstehende Pairing-Anfragen prüfen:

openclaw pairing list feishu

Häufige Befehle

Command	Beschreibung
`/status`	Bot-Status anzeigen
`/reset`	Die aktuelle Sitzung zurücksetzen
`/model`	Das KI-Modell anzeigen oder wechseln

Feishu/Lark unterstützt keine nativen Slash-Command-Menüs, senden Sie diese daher als einfache Textnachrichten.

Fehlerbehebung

Bot antwortet nicht in Gruppenchats

Stellen Sie sicher, dass der Bot zur Gruppe hinzugefügt wurde
Stellen Sie sicher, dass Sie den Bot per @ erwähnen (standardmäßig erforderlich)
Vergewissern Sie sich, dass groupPolicy nicht "disabled" ist
Prüfen Sie die Protokolle: openclaw logs --follow

Bot empfängt keine Nachrichten

Stellen Sie sicher, dass der Bot in Feishu Open Platform / Lark Developer veröffentlicht und genehmigt ist
Stellen Sie sicher, dass das Event-Abonnement im.message.receive_v1 enthält
Stellen Sie sicher, dass persistent connection (WebSocket) ausgewählt ist
Stellen Sie sicher, dass alle erforderlichen Berechtigungsbereiche gewährt wurden
Stellen Sie sicher, dass das Gateway ausgeführt wird: openclaw gateway status
Prüfen Sie die Protokolle: openclaw logs --follow

App Secret wurde offengelegt

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

Erweiterte Konfiguration

Mehrere Konten

{
  channels: {
    feishu: {
      defaultAccount: "main",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          name: "Primärer Bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          name: "Backup-Bot",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount steuert, welches Konto verwendet wird, wenn ausgehende APIs kein accountId angeben.

Nachrichtenlimits

textChunkLimit — Größe ausgehender Textabschnitte (Standard: 2000 Zeichen)
mediaMaxMb — Upload-/Download-Limit für Medien (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, // Streaming-Kartenausgabe aktivieren (Standard: true)
      blockStreaming: true, // Streaming auf Blockebene aktivieren (Standard: true)
    },
  },
}

Setzen Sie streaming: false, um die vollständige Antwort in einer Nachricht zu senden.

Quotenoptimierung

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

typingIndicator (Standard true): auf false setzen, um Reaktionsaufrufe für die Eingabeanzeige zu überspringen
resolveSenderNames (Standard true): auf false setzen, um Profilabfragen der Absender zu überspringen

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

ACP-Sitzungen

Feishu/Lark unterstützt ACP für DMs und Gruppen-Thread-Nachrichten. Feishu/Lark ACP ist textbefehlsgesteuert — 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 dem Chat starten

In einer Feishu-/Lark-DM oder einem Thread:

/acp spawn codex --thread here

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

Multi-Agent-Routing

Verwenden Sie bindings, um Feishu-/Lark-DMs oder Gruppen an verschiedene Agents 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" (DM) 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

Setting	Beschreibung	Standard
`channels.feishu.enabled`	Den Kanal aktivieren/deaktivieren	`true`
`channels.feishu.domain`	API-Domain (`feishu` oder `lark`)	`feishu`
`channels.feishu.connectionMode`	Event-Transport (`websocket` oder `webhook`)	`websocket`
`channels.feishu.defaultAccount`	Standardkonto für ausgehendes Routing	`default`
`channels.feishu.verificationToken`	Erforderlich für den Webhook-Modus	—
`channels.feishu.encryptKey`	Erforderlich für den Webhook-Modus	—
`channels.feishu.webhookPath`	Pfad der Webhook-Route	`/feishu/events`
`channels.feishu.webhookHost`	Bind-Host des Webhooks	`127.0.0.1`
`channels.feishu.webhookPort`	Bind-Port des Webhooks	`3000`
`channels.feishu.accounts.<id>.appId`	App-ID	—
`channels.feishu.accounts.<id>.appSecret`	App Secret	—
`channels.feishu.accounts.<id>.domain`	Domain-Überschreibung pro Konto	`feishu`
`channels.feishu.dmPolicy`	DM-Richtlinie	`allowlist`
`channels.feishu.allowFrom`	DM-Allowlist (Liste der `open_id`)	[BotOwnerId]
`channels.feishu.groupPolicy`	Gruppenrichtlinie	`allowlist`
`channels.feishu.groupAllowFrom`	Gruppen-Allowlist	—
`channels.feishu.requireMention`	@Erwähnung in Gruppen erforderlich	`true`
`channels.feishu.groups.<chat_id>.requireMention`	@Erwähnungs-Überschreibung pro Gruppe	vererbt
`channels.feishu.groups.<chat_id>.enabled`	Eine bestimmte Gruppe aktivieren/deaktivieren	`true`
`channels.feishu.textChunkLimit`	Größe der Nachrichtenabschnitte	`2000`
`channels.feishu.mediaMaxMb`	Größenlimit für Medien	`30`
`channels.feishu.streaming`	Streaming-Kartenausgabe	`true`
`channels.feishu.blockStreaming`	Streaming auf Blockebene	`true`
`channels.feishu.typingIndicator`	Eingabereaktionen senden	`true`
`channels.feishu.resolveSenderNames`	Anzeigenamen der Absender auflösen	`true`

Unterstützte Nachrichtentypen

Empfangen

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

Senden

✅ Text
✅ Bilder
✅ Dateien
✅ Audio
✅ Video/Medien
✅ Interaktive Karten (einschließlich Streaming-Updates)
⚠️ Rich Text (Formatierung im Post-Stil; unterstützt nicht den vollen Feishu-/Lark-Funktionsumfang beim Verfassen)

Threads und Antworten

✅ Inline-Antworten
✅ Thread-Antworten
✅ Medienantworten bleiben beim Antworten auf eine Thread-Nachricht thread-sensitiv

Verwandt

Kanalübersicht — alle unterstützten Kanäle
Pairing — DM-Authentifizierung und Pairing-Ablauf
Gruppen — Verhalten in Gruppenchats und Steuerung über Erwähnungen
Kanal-Routing — Sitzungs-Routing für Nachrichten
Sicherheit — Zugriffsmodell und Härtung

Overview

Messaging platforms

Configuration

Feishu

Feishu / Lark

Schnellstart

Zugriffskontrolle

Direktnachrichten

Gruppenchats

Beispiele für die Gruppenkonfiguration

Alle Gruppen zulassen, keine @Erwähnung erforderlich

Alle Gruppen zulassen, aber weiterhin @Erwähnung erforderlich

Nur bestimmte Gruppen zulassen

Absender innerhalb einer Gruppe einschränken

Gruppen-/Benutzer-IDs abrufen

Gruppen-IDs (`chat_id`, Format: `oc_xxx`)

Benutzer-IDs (`open_id`, Format: `ou_xxx`)

Häufige Befehle

Fehlerbehebung

Bot antwortet nicht in Gruppenchats

Bot empfängt keine Nachrichten

App Secret wurde offengelegt

Erweiterte Konfiguration

Mehrere Konten

Nachrichtenlimits

Streaming

Quotenoptimierung

ACP-Sitzungen

Persistente ACP-Bindung

ACP aus dem Chat starten

Multi-Agent-Routing

Konfigurationsreferenz

Unterstützte Nachrichtentypen

Empfangen

Senden

Threads und Antworten

Verwandt

Overview

Messaging platforms

Configuration

​Feishu / Lark

​Schnellstart

​Zugriffskontrolle

​Direktnachrichten

​Gruppenchats

​Beispiele für die Gruppenkonfiguration

​Alle Gruppen zulassen, keine @Erwähnung erforderlich

​Alle Gruppen zulassen, aber weiterhin @Erwähnung erforderlich

​Nur bestimmte Gruppen zulassen

​Absender innerhalb einer Gruppe einschränken

​Gruppen-/Benutzer-IDs abrufen

​Gruppen-IDs (chat_id, Format: oc_xxx)

​Benutzer-IDs (open_id, Format: ou_xxx)

​Häufige Befehle

​Fehlerbehebung

​Bot antwortet nicht in Gruppenchats

​Bot empfängt keine Nachrichten

​App Secret wurde offengelegt

​Erweiterte Konfiguration

​Mehrere Konten

​Nachrichtenlimits

​Streaming

​Quotenoptimierung

​ACP-Sitzungen

​Persistente ACP-Bindung

​ACP aus dem Chat starten

​Multi-Agent-Routing

​Konfigurationsreferenz

​Unterstützte Nachrichtentypen

​Empfangen

​Senden

​Threads und Antworten

​Verwandt

Feishu / Lark

Schnellstart

Zugriffskontrolle

Direktnachrichten

Gruppenchats

Beispiele für die Gruppenkonfiguration

Alle Gruppen zulassen, keine @Erwähnung erforderlich

Alle Gruppen zulassen, aber weiterhin @Erwähnung erforderlich

Nur bestimmte Gruppen zulassen

Absender innerhalb einer Gruppe einschränken

Gruppen-/Benutzer-IDs abrufen

Gruppen-IDs (`chat_id`, Format: `oc_xxx`)

Benutzer-IDs (`open_id`, Format: `ou_xxx`)

Häufige Befehle

Fehlerbehebung

Bot antwortet nicht in Gruppenchats

Bot empfängt keine Nachrichten

App Secret wurde offengelegt

Erweiterte Konfiguration

Mehrere Konten

Nachrichtenlimits

Streaming

Quotenoptimierung

ACP-Sitzungen

Persistente ACP-Bindung

ACP aus dem Chat starten

Multi-Agent-Routing

Konfigurationsreferenz

Unterstützte Nachrichtentypen

Empfangen

Senden

Threads und Antworten

Verwandt