---
read_when:
    - Sie möchten einen Feishu-/Lark-Bot verbinden
    - Sie konfigurieren den Feishu-Kanal
summary: Feishu-Bot-Überblick, Funktionen und Konfiguration
title: Feishu
x-i18n:
    generated_at: "2026-04-13T12:36:51Z"
    model: gpt-5.4
    provider: openai
    source_hash: 77fcf95a3fab534ed898bc157d76bf8bdfa8bf8a918d6af84c0db19890916c1a
    source_path: channels/feishu.md
    workflow: 15
---

# 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`.

<Steps>
  <Step title="Führen Sie den Einrichtungsassistenten für den Kanal aus">
  ```bash
  openclaw channels login --channel feishu
  ```
  Scannen Sie den QR-Code mit Ihrer Feishu-/Lark-Mobil-App, um automatisch einen Feishu-/Lark-Bot zu erstellen.
  </Step>
  
  <Step title="Nachdem die Einrichtung abgeschlossen ist, starten Sie das Gateway neu, um die Änderungen anzuwenden">
  ```bash
  openclaw gateway restart
  ```
  </Step>
</Steps>

---

## 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:**

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

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

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

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

### Nur bestimmte Gruppen zulassen

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

### Absender innerhalb einer Gruppe einschränken

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

![Get Group ID](/images/feishu-get-group-id.png)

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

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

```bash
openclaw logs --follow
```

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

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

1. Stellen Sie sicher, dass der Bot zur Gruppe hinzugefügt wurde
2. Stellen Sie sicher, dass Sie den Bot per @ erwähnen (standardmäßig erforderlich)
3. Vergewissern Sie sich, dass `groupPolicy` nicht `"disabled"` ist
4. Prüfen Sie die Protokolle: `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 Event-Abonnement `im.message.receive_v1` enthält
3. Stellen Sie sicher, dass **persistent connection** (WebSocket) ausgewählt ist
4. Stellen Sie sicher, dass alle erforderlichen Berechtigungsbereiche gewährt wurden
5. Stellen Sie sicher, dass das Gateway ausgeführt wird: `openclaw gateway status`
6. Prüfen Sie die Protokolle: `openclaw logs --follow`

### App Secret wurde offengelegt

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

---

## Erweiterte Konfiguration

### Mehrere Konten

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

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

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

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

```text
/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.

```json5
{
  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](#gruppen-benutzer-ids-abrufen) für Tipps zum Nachschlagen.

---

## Konfigurationsreferenz

Vollständige Konfiguration: [Gateway-Konfiguration](/de/gateway/configuration)

| 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](/de/channels) — alle unterstützten Kanäle
- [Pairing](/de/channels/pairing) — DM-Authentifizierung und Pairing-Ablauf
- [Gruppen](/de/channels/groups) — Verhalten in Gruppenchats und Steuerung über Erwähnungen
- [Kanal-Routing](/de/channels/channel-routing) — Sitzungs-Routing für Nachrichten
- [Sicherheit](/de/gateway/security) — Zugriffsmodell und Härtung
