From cbb5ab4da8f9fa3e7ba9c6d66094a9f1de0ead9c Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 13 Apr 2026 12:37:36 +0000 Subject: [PATCH] chore(i18n): refresh de translations --- docs/de/channels/feishu.md | 653 +++++++++---------------------------- 1 file changed, 152 insertions(+), 501 deletions(-) diff --git a/docs/de/channels/feishu.md b/docs/de/channels/feishu.md index 16db42d13..6b8dc0437 100644 --- a/docs/de/channels/feishu.md +++ b/docs/de/channels/feishu.md @@ -2,306 +2,43 @@ read_when: - Sie möchten einen Feishu-/Lark-Bot verbinden - Sie konfigurieren den Feishu-Kanal -summary: Überblick, Funktionen und Konfiguration des Feishu-Bots +summary: Feishu-Bot-Überblick, Funktionen und Konfiguration title: Feishu x-i18n: - generated_at: "2026-04-05T12:35:33Z" + generated_at: "2026-04-13T12:36:51Z" model: gpt-5.4 provider: openai - source_hash: 4e39b6dfe3a3aa4ebbdb992975e570e4f1b5e79f3b400a555fc373a0d1889952 + source_hash: 77fcf95a3fab534ed898bc157d76bf8bdfa8bf8a918d6af84c0db19890916c1a source_path: channels/feishu.md workflow: 15 --- -# Feishu-Bot +# Feishu / Lark -Feishu (Lark) ist eine Team-Chat-Plattform, die von Unternehmen für Messaging und Zusammenarbeit genutzt wird. Dieses Plugin verbindet OpenClaw mit einem Feishu-/Lark-Bot über das WebSocket-Ereignisabonnement der Plattform, sodass Nachrichten empfangen werden können, ohne eine öffentliche Webhook-URL offenzulegen. +Feishu/Lark ist eine All-in-one-Kollaborationsplattform, auf der Teams chatten, Dokumente teilen, Kalender verwalten und gemeinsam arbeiten. ---- - -## Gebündeltes Plugin - -Feishu ist in aktuellen OpenClaw-Versionen gebündelt enthalten, daher ist keine separate Plugin-Installation erforderlich. - -Wenn Sie einen älteren Build oder eine benutzerdefinierte Installation verwenden, die das gebündelte -Feishu nicht enthält, installieren Sie es manuell: - -```bash -openclaw plugins install @openclaw/feishu -``` +**Status:** produktionsbereit für Bot-DMs und Gruppenchats. WebSocket ist der Standardmodus; der Webhook-Modus ist optional. --- ## Schnellstart -Es gibt zwei Möglichkeiten, den Feishu-Kanal hinzuzufügen: - -### Methode 1: Onboarding (empfohlen) - -Wenn Sie OpenClaw gerade installiert haben, führen Sie das Onboarding aus: - -```bash -openclaw onboard -``` - -Der Assistent führt Sie durch folgende Schritte: - -1. Eine Feishu-App erstellen und Zugangsdaten erfassen -2. App-Zugangsdaten in OpenClaw konfigurieren -3. Das Gateway starten - -✅ **Nach der Konfiguration** prüfen Sie den Gateway-Status: - -- `openclaw gateway status` -- `openclaw logs --follow` - -### Methode 2: Einrichtung per CLI - -Wenn Sie die Erstinstallation bereits abgeschlossen haben, fügen Sie den Kanal über die CLI hinzu: - -```bash -openclaw channels add -``` - -Wählen Sie **Feishu** und geben Sie dann die App ID und das App Secret ein. - -✅ **Nach der Konfiguration** verwalten Sie das Gateway: - -- `openclaw gateway status` -- `openclaw gateway restart` -- `openclaw logs --follow` - ---- - -## Schritt 1: Eine Feishu-App erstellen - -### 1. Feishu Open Platform öffnen - -Besuchen Sie die [Feishu Open Platform](https://open.feishu.cn/app) und melden Sie sich an. - -Lark-Mandanten (global) sollten [https://open.larksuite.com/app](https://open.larksuite.com/app) verwenden und in der Feishu-Konfiguration `domain: "lark"` setzen. - -### 2. Eine App erstellen - -1. Klicken Sie auf **Create enterprise app** -2. Geben Sie den App-Namen und die Beschreibung ein -3. Wählen Sie ein App-Symbol - -![Create enterprise app](/images/feishu-step2-create-app.png) - -### 3. Zugangsdaten kopieren - -Kopieren Sie unter **Credentials & Basic Info**: - -- **App ID** (Format: `cli_xxx`) -- **App Secret** - -❗ **Wichtig:** Halten Sie das App Secret privat. - -![Get credentials](/images/feishu-step3-credentials.png) - -### 4. Berechtigungen konfigurieren - -Klicken Sie unter **Permissions** auf **Batch import** und fügen Sie Folgendes ein: - -```json -{ - "scopes": { - "tenant": [ - "aily:file:read", - "aily:file:write", - "application:application.app_message_stats.overview:readonly", - "application:application:self_manage", - "application:bot.menu:write", - "cardkit:card:read", - "cardkit:card:write", - "contact:user.employee_id:readonly", - "corehr:file:download", - "event:ip_list", - "im:chat.access_event.bot_p2p_chat:read", - "im:chat.members:bot_access", - "im:message", - "im:message.group_at_msg:readonly", - "im:message.p2p_msg:readonly", - "im:message:readonly", - "im:message:send_as_bot", - "im:resource" - ], - "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] - } -} -``` - -![Configure permissions](/images/feishu-step4-permissions.png) - -### 5. Bot-Funktion aktivieren - -Unter **App Capability** > **Bot**: - -1. Aktivieren Sie die Bot-Funktion -2. Legen Sie den Bot-Namen fest - -![Enable bot capability](/images/feishu-step5-bot-capability.png) - -### 6. Ereignisabonnement konfigurieren - -⚠️ **Wichtig:** Bevor Sie das Ereignisabonnement einrichten, stellen Sie sicher: - -1. Sie haben `openclaw channels add` für Feishu bereits ausgeführt -2. Das Gateway läuft (`openclaw gateway status`) - -Unter **Event Subscription**: - -1. Wählen Sie **Use long connection to receive events** (WebSocket) -2. Fügen Sie das Ereignis `im.message.receive_v1` hinzu -3. (Optional) Für Drive-Kommentar-Workflows fügen Sie außerdem `drive.notice.comment_add_v1` hinzu - -⚠️ Wenn das Gateway nicht läuft, kann die Long-Connection-Einrichtung möglicherweise nicht gespeichert werden. - -![Configure event subscription](/images/feishu-step6-event-subscription.png) - -### 7. Die App veröffentlichen - -1. Erstellen Sie eine Version unter **Version Management & Release** -2. Reichen Sie sie zur Prüfung ein und veröffentlichen Sie sie -3. Warten Sie auf die Admin-Genehmigung (Enterprise-Apps werden normalerweise automatisch genehmigt) - ---- - -## Schritt 2: OpenClaw konfigurieren - -### Mit dem Assistenten konfigurieren (empfohlen) - -```bash -openclaw channels add -``` - -Wählen Sie **Feishu** und fügen Sie Ihre App ID und Ihr App Secret ein. - -### Über die Konfigurationsdatei konfigurieren - -Bearbeiten Sie `~/.openclaw/openclaw.json`: - -```json5 -{ - channels: { - feishu: { - enabled: true, - dmPolicy: "pairing", - accounts: { - main: { - appId: "cli_xxx", - appSecret: "xxx", - name: "My AI assistant", - }, - }, - }, - }, -} -``` - -Wenn Sie `connectionMode: "webhook"` verwenden, setzen Sie sowohl `verificationToken` als auch `encryptKey`. Der Feishu-Webhook-Server bindet standardmäßig an `127.0.0.1`; setzen Sie `webhookHost` nur, wenn Sie absichtlich eine andere Bind-Adresse benötigen. - -#### Verification Token und Encrypt Key (Webhook-Modus) - -Wenn Sie den Webhook-Modus verwenden, setzen Sie sowohl `channels.feishu.verificationToken` als auch `channels.feishu.encryptKey` in Ihrer Konfiguration. So erhalten Sie die Werte: - -1. Öffnen Sie in der Feishu Open Platform Ihre App -2. Gehen Sie zu **Development** → **Events & Callbacks** (开发配置 → 事件与回调) -3. Öffnen Sie den Tab **Encryption** (加密策略) -4. Kopieren Sie **Verification Token** und **Encrypt Key** - -Der Screenshot unten zeigt, wo sich der **Verification Token** befindet. Der **Encrypt Key** ist im selben Abschnitt **Encryption** aufgeführt. - -![Verification Token location](/images/feishu-verification-token.png) - -### Über Umgebungsvariablen konfigurieren - -```bash -export FEISHU_APP_ID="cli_xxx" -export FEISHU_APP_SECRET="xxx" -``` - -### Lark-Domain (global) - -Wenn Ihr Mandant auf Lark (international) läuft, setzen Sie die Domain auf `lark` (oder auf eine vollständige Domain-Zeichenfolge). Sie können dies unter `channels.feishu.domain` oder pro Konto (`channels.feishu.accounts..domain`) festlegen. - -```json5 -{ - channels: { - feishu: { - domain: "lark", - accounts: { - main: { - appId: "cli_xxx", - appSecret: "xxx", - }, - }, - }, - }, -} -``` - -### Flags zur Quotenoptimierung - -Sie können die Nutzung der Feishu-API mit zwei optionalen Flags reduzieren: - -- `typingIndicator` (Standard `true`): Wenn `false`, werden Aufrufe für Schreibreaktionen übersprungen. -- `resolveSenderNames` (Standard `true`): Wenn `false`, werden Aufrufe zur Abfrage von Senderprofilen übersprungen. - -Setzen Sie sie auf oberster Ebene oder pro Konto: - -```json5 -{ - channels: { - feishu: { - typingIndicator: false, - resolveSenderNames: false, - accounts: { - main: { - appId: "cli_xxx", - appSecret: "xxx", - typingIndicator: true, - resolveSenderNames: false, - }, - }, - }, - }, -} -``` - ---- - -## Schritt 3: Starten und testen - -### 1. Das Gateway starten - -```bash -openclaw gateway -``` - -### 2. Eine Testnachricht senden - -Suchen Sie in Feishu Ihren Bot und senden Sie eine Nachricht. - -### 3. Pairing genehmigen - -Standardmäßig antwortet der Bot mit einem Pairing-Code. Genehmigen Sie ihn: - -```bash -openclaw pairing approve feishu -``` - -Nach der Genehmigung können Sie normal chatten. - ---- - -## Überblick - -- **Feishu-Bot-Kanal**: Vom Gateway verwalteter Feishu-Bot -- **Deterministisches Routing**: Antworten gehen immer an Feishu zurück -- **Sitzungsisolierung**: DMs teilen sich eine Hauptsitzung; Gruppen sind isoliert -- **WebSocket-Verbindung**: Long Connection über das Feishu SDK, keine öffentliche URL erforderlich +> **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`. + + + + ```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. + + + + ```bash + openclaw gateway restart + ``` + + --- @@ -309,38 +46,43 @@ Nach der Genehmigung können Sie normal chatten. ### Direktnachrichten -- **Standard**: `dmPolicy: "pairing"` (unbekannte Benutzer erhalten einen Pairing-Code) -- **Pairing genehmigen**: +Konfigurieren Sie `dmPolicy`, um zu steuern, wer dem Bot Direktnachrichten senden kann: - ```bash - openclaw pairing list feishu - openclaw pairing approve feishu - ``` +- `"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 -- **Allowlist-Modus**: Setzen Sie `channels.feishu.allowFrom` mit erlaubten Open IDs +**Eine Pairing-Anfrage freigeben:** + +```bash +openclaw pairing list feishu +openclaw pairing approve feishu +``` ### Gruppenchats -**1. Gruppenrichtlinie** (`channels.feishu.groupPolicy`): +**Gruppenrichtlinie** (`channels.feishu.groupPolicy`): -- `"open"` = alle in Gruppen zulassen -- `"allowlist"` = nur `groupAllowFrom` zulassen -- `"disabled"` = Gruppennachrichten deaktivieren +| Value | Verhalten | +| ------------- | ----------------------------------------- | +| `"open"` | Auf alle Nachrichten in Gruppen antworten | +| `"allowlist"` | Nur auf Gruppen in `groupAllowFrom` antworten | +| `"disabled"` | Alle Gruppennachrichten deaktivieren | Standard: `allowlist` -**2. Mention-Anforderung** (`channels.feishu.requireMention`, überschreibbar über `channels.feishu.groups..requireMention`): +**Erforderliche Erwähnung** (`channels.feishu.requireMention`): -- explizit `true` = @mention erforderlich -- explizit `false` = ohne Mentions antworten -- wenn nicht gesetzt und `groupPolicy: "open"` = Standard ist `false` -- wenn nicht gesetzt und `groupPolicy` nicht `"open"` ist = Standard ist `true` +- `true` — @Erwähnung erforderlich (Standard) +- `false` — ohne @Erwähnung antworten +- Pro-Gruppe-Überschreibung: `channels.feishu.groups..requireMention` --- -## Beispiele für Gruppenkonfigurationen +## Beispiele für die Gruppenkonfiguration -### Alle Gruppen zulassen, keine @mention erforderlich (Standard für offene Gruppen) +### Alle Gruppen zulassen, keine @Erwähnung erforderlich ```json5 { @@ -352,7 +94,7 @@ Standard: `allowlist` } ``` -### Alle Gruppen zulassen, aber weiterhin @mention verlangen +### Alle Gruppen zulassen, aber weiterhin @Erwähnung erforderlich ```json5 { @@ -372,16 +114,14 @@ Standard: `allowlist` channels: { feishu: { groupPolicy: "allowlist", - // Feishu-Gruppen-IDs (chat_id) sehen so aus: oc_xxx + // Gruppen-IDs sehen so aus: oc_xxx groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } ``` -### Einschränken, welche Absender in einer Gruppe Nachrichten senden dürfen (Absender-Allowlist) - -Zusätzlich dazu, dass die Gruppe selbst erlaubt sein muss, werden **alle Nachrichten** in dieser Gruppe durch die Open-ID des Absenders eingeschränkt: Nur Benutzer, die in `groups..allowFrom` aufgeführt sind, werden verarbeitet; Nachrichten anderer Mitglieder werden ignoriert (dies ist eine vollständige Einschränkung auf Absenderebene, nicht nur für Steuerbefehle wie /reset oder /new). +### Absender innerhalb einer Gruppe einschränken ```json5 { @@ -391,7 +131,7 @@ Zusätzlich dazu, dass die Gruppe selbst erlaubt sein muss, werden **alle Nachri groupAllowFrom: ["oc_xxx"], groups: { oc_xxx: { - // Feishu-Benutzer-IDs (open_id) sehen so aus: ou_xxx + // Benutzer-open_ids sehen so aus: ou_xxx allowFrom: ["ou_user1", "ou_user2"], }, }, @@ -402,35 +142,23 @@ Zusätzlich dazu, dass die Gruppe selbst erlaubt sein muss, werden **alle Nachri --- - - ## Gruppen-/Benutzer-IDs abrufen -### Gruppen-IDs (chat_id) +### Gruppen-IDs (`chat_id`, Format: `oc_xxx`) -Gruppen-IDs sehen so aus: `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. -**Methode 1 (empfohlen)** +![Get Group ID](/images/feishu-get-group-id.png) -1. Starten Sie das Gateway und @mentionen Sie den Bot in der Gruppe -2. Führen Sie `openclaw logs --follow` aus und suchen Sie nach `chat_id` +### Benutzer-IDs (`open_id`, Format: `ou_xxx`) -**Methode 2** +Starten Sie das Gateway, senden Sie dem Bot eine Direktnachricht und prüfen Sie dann die Protokolle: -Verwenden Sie den Feishu-API-Debugger, um Gruppenchats aufzulisten. +```bash +openclaw logs --follow +``` -### Benutzer-IDs (open_id) - -Benutzer-IDs sehen so aus: `ou_xxx`. - -**Methode 1 (empfohlen)** - -1. Starten Sie das Gateway und senden Sie dem Bot eine DM -2. Führen Sie `openclaw logs --follow` aus und suchen Sie nach `open_id` - -**Methode 2** - -Prüfen Sie Pairing-Anfragen auf Benutzer-Open-IDs: +Suchen Sie in der Protokollausgabe nach `open_id`. Sie können auch ausstehende Pairing-Anfragen prüfen: ```bash openclaw pairing list feishu @@ -440,23 +168,13 @@ openclaw pairing list feishu ## Häufige Befehle -| Befehl | Beschreibung | -| --------- | ------------------------------ | -| `/status` | Bot-Status anzeigen | -| `/reset` | Die Sitzung zurücksetzen | -| `/model` | Modell anzeigen/wechseln | +| Command | Beschreibung | +| --------- | ------------------------------- | +| `/status` | Bot-Status anzeigen | +| `/reset` | Die aktuelle Sitzung zurücksetzen | +| `/model` | Das KI-Modell anzeigen oder wechseln | -> Hinweis: Feishu unterstützt derzeit keine nativen Befehlsmenüs, daher müssen Befehle als Text gesendet werden. - -## Gateway-Verwaltungsbefehle - -| Befehl | Beschreibung | -| -------------------------- | ------------------------------ | -| `openclaw gateway status` | Gateway-Status anzeigen | -| `openclaw gateway install` | Gateway-Dienst installieren/starten | -| `openclaw gateway stop` | Gateway-Dienst stoppen | -| `openclaw gateway restart` | Gateway-Dienst neu starten | -| `openclaw logs --follow` | Gateway-Protokolle mitverfolgen | +> Feishu/Lark unterstützt keine nativen Slash-Command-Menüs, senden Sie diese daher als einfache Textnachrichten. --- @@ -465,30 +183,24 @@ openclaw pairing list feishu ### 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 @mentionen (Standardverhalten) -3. Prüfen Sie, ob `groupPolicy` nicht auf `"disabled"` gesetzt ist +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 die App veröffentlicht und genehmigt ist -2. Stellen Sie sicher, dass das Ereignisabonnement `im.message.receive_v1` enthält -3. Stellen Sie sicher, dass **long connection** aktiviert ist -4. Stellen Sie sicher, dass die App-Berechtigungen vollständig sind -5. Stellen Sie sicher, dass das Gateway läuft: `openclaw gateway status` +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 offengelegt +### App Secret wurde offengelegt -1. Setzen Sie das App Secret in der Feishu Open Platform zurück -2. Aktualisieren Sie das App Secret in Ihrer Konfiguration -3. Starten Sie das Gateway neu - -### Fehler beim Senden von Nachrichten - -1. Stellen Sie sicher, dass die App die Berechtigung `im:message:send_as_bot` hat -2. Stellen Sie sicher, dass die App veröffentlicht ist -3. Prüfen Sie die Protokolle auf detaillierte Fehler +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` --- @@ -505,12 +217,12 @@ openclaw pairing list feishu main: { appId: "cli_xxx", appSecret: "xxx", - name: "Primary bot", + name: "Primärer Bot", }, backup: { appId: "cli_yyy", appSecret: "yyy", - name: "Backup bot", + name: "Backup-Bot", enabled: false, }, }, @@ -519,42 +231,53 @@ openclaw pairing list feishu } ``` -`defaultAccount` steuert, welches Feishu-Konto verwendet wird, wenn ausgehende APIs nicht ausdrücklich ein `accountId` angeben. +`defaultAccount` steuert, welches Konto verwendet wird, wenn ausgehende APIs kein `accountId` angeben. ### Nachrichtenlimits -- `textChunkLimit`: Größe von Textabschnitten für ausgehende Nachrichten (Standard: 2000 Zeichen) -- `mediaMaxMb`: Limit für Upload/Download von Medien (Standard: 30MB) +- `textChunkLimit` — Größe ausgehender Textabschnitte (Standard: `2000` Zeichen) +- `mediaMaxMb` — Upload-/Download-Limit für Medien (Standard: `30` MB) ### Streaming -Feishu unterstützt Streaming-Antworten über interaktive Karten. Wenn aktiviert, aktualisiert der Bot während der Textgenerierung eine Karte. +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) + streaming: true, // Streaming-Kartenausgabe aktivieren (Standard: true) + blockStreaming: true, // Streaming auf Blockebene aktivieren (Standard: true) }, }, } ``` -Setzen Sie `streaming: false`, um auf die vollständige Antwort zu warten, bevor sie gesendet wird. +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 unterstützt ACP für: +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. -- DMs -- Gruppen-Topic-Konversationen - -Feishu ACP ist textbefehlsgesteuert. Es gibt keine nativen Slash-Command-Menüs, verwenden Sie daher `/acp ...`-Nachrichten direkt in der Konversation. - -#### Persistente ACP-Bindings - -Verwenden Sie typisierte ACP-Bindings auf oberster Ebene, um eine Feishu-DM oder Topic-Konversation an eine persistente ACP-Sitzung zu binden. +#### Persistente ACP-Bindung ```json5 { @@ -598,58 +321,39 @@ Verwenden Sie typisierte ACP-Bindings auf oberster Ebene, um eine Feishu-DM oder } ``` -#### Thread-gebundener ACP-Spawn aus dem Chat +#### ACP aus dem Chat starten -In einer Feishu-DM oder Topic-Konversation können Sie direkt eine ACP-Sitzung erzeugen und binden: +In einer Feishu-/Lark-DM oder einem Thread: ```text /acp spawn codex --thread here ``` -Hinweise: - -- `--thread here` funktioniert für DMs und Feishu-Topics. -- Nachfolgende Nachrichten in der gebundenen DM/im gebundenen Topic werden direkt an diese ACP-Sitzung weitergeleitet. -- v1 zielt nicht auf allgemeine Gruppenchats ohne Topic ab. +`--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-DMs oder -Gruppen an unterschiedliche Agenten weiterzuleiten. +Verwenden Sie `bindings`, um Feishu-/Lark-DMs oder Gruppen an verschiedene Agents weiterzuleiten. ```json5 { agents: { list: [ { id: "main" }, - { - id: "clawd-fan", - workspace: "/home/user/clawd-fan", - agentDir: "/home/user/.openclaw/agents/clawd-fan/agent", - }, - { - id: "clawd-xi", - workspace: "/home/user/clawd-xi", - agentDir: "/home/user/.openclaw/agents/clawd-xi/agent", - }, + { id: "agent-a", workspace: "/home/user/agent-a" }, + { id: "agent-b", workspace: "/home/user/agent-b" }, ], }, bindings: [ { - agentId: "main", + agentId: "agent-a", match: { channel: "feishu", peer: { kind: "direct", id: "ou_xxx" }, }, }, { - agentId: "clawd-fan", - match: { - channel: "feishu", - peer: { kind: "direct", id: "ou_yyy" }, - }, - }, - { - agentId: "clawd-xi", + agentId: "agent-b", match: { channel: "feishu", peer: { kind: "group", id: "oc_zzz" }, @@ -662,55 +366,44 @@ Verwenden Sie `bindings`, um Feishu-DMs oder -Gruppen an unterschiedliche Agente Routing-Felder: - `match.channel`: `"feishu"` -- `match.peer.kind`: `"direct"` oder `"group"` +- `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](#get-groupuser-ids) für Hinweise zur Ermittlung. +Siehe [Gruppen-/Benutzer-IDs abrufen](#gruppen-benutzer-ids-abrufen) für Tipps zum Nachschlagen. --- ## Konfigurationsreferenz -Vollständige Konfiguration: [Gateway-Konfiguration](/gateway/configuration) +Vollständige Konfiguration: [Gateway-Konfiguration](/de/gateway/configuration) -Wichtige Optionen: - -| Einstellung | Beschreibung | Standard | -| ------------------------------------------------- | -------------------------------------- | ---------------- | -| `channels.feishu.enabled` | Kanal aktivieren/deaktivieren | `true` | -| `channels.feishu.domain` | API-Domain (`feishu` oder `lark`) | `feishu` | -| `channels.feishu.connectionMode` | Modus für den Ereignistransport | `websocket` | -| `channels.feishu.defaultAccount` | Standard-Konto-ID 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` | Webhook-Bind-Host | `127.0.0.1` | -| `channels.feishu.webhookPort` | Webhook-Bind-Port | `3000` | -| `channels.feishu.accounts..appId` | App ID | - | -| `channels.feishu.accounts..appSecret` | App Secret | - | -| `channels.feishu.accounts..domain` | Überschreibung der API-Domain pro Konto | `feishu` | -| `channels.feishu.dmPolicy` | DM-Richtlinie | `pairing` | -| `channels.feishu.allowFrom` | DM-Allowlist (open_id-Liste) | - | -| `channels.feishu.groupPolicy` | Gruppenrichtlinie | `allowlist` | -| `channels.feishu.groupAllowFrom` | Gruppen-Allowlist | - | -| `channels.feishu.requireMention` | Standardmäßig @mention erforderlich | bedingt | -| `channels.feishu.groups..requireMention` | Überschreibung für @mention pro Gruppe | vererbt | -| `channels.feishu.groups..enabled` | Gruppe aktivieren | `true` | -| `channels.feishu.textChunkLimit` | Größe von Nachrichtenabschnitten | `2000` | -| `channels.feishu.mediaMaxMb` | Größenlimit für Medien | `30` | -| `channels.feishu.streaming` | Streaming-Kartenausgabe aktivieren | `true` | -| `channels.feishu.blockStreaming` | Block-Streaming aktivieren | `true` | - ---- - -## dmPolicy-Referenz - -| Wert | Verhalten | -| ------------- | --------------------------------------------------------------- | -| `"pairing"` | **Standard.** Unbekannte Benutzer erhalten einen Pairing-Code und müssen genehmigt werden | -| `"allowlist"` | Nur Benutzer in `allowFrom` können chatten | -| `"open"` | Alle Benutzer zulassen (erfordert `"*"` in `allowFrom`) | -| `"disabled"` | DMs deaktivieren | +| 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..appId` | App-ID | — | +| `channels.feishu.accounts..appSecret` | App Secret | — | +| `channels.feishu.accounts..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..requireMention` | @Erwähnungs-Überschreibung pro Gruppe | vererbt | +| `channels.feishu.groups..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` | --- @@ -733,63 +426,21 @@ Wichtige Optionen: - ✅ Dateien - ✅ Audio - ✅ Video/Medien -- ✅ Interaktive Karten -- ⚠️ Rich Text (Formatierung im Post-Stil und Karten, nicht beliebige Feishu-Autorenfunktionen) +- ✅ 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 -- ✅ Topic-Thread-Antworten, wenn Feishu `reply_in_thread` bereitstellt -- ✅ Medienantworten bleiben threadbewusst, wenn auf eine Thread-/Topic-Nachricht geantwortet wird +- ✅ Thread-Antworten +- ✅ Medienantworten bleiben beim Antworten auf eine Thread-Nachricht thread-sensitiv -## Drive-Kommentare - -Feishu kann den Agenten auslösen, wenn jemand einen Kommentar zu einem Feishu-Drive-Dokument hinzufügt (Docs, Sheets usw.). Der Agent erhält den Kommentartext, den Dokumentkontext und den Kommentar-Thread, damit er im Thread antworten oder Dokumentbearbeitungen vornehmen kann. - -Anforderungen: - -- Abonnieren Sie `drive.notice.comment_add_v1` in den Ereignisabonnement-Einstellungen Ihrer Feishu-App - (zusammen mit dem vorhandenen `im.message.receive_v1`) -- Das Drive-Tool ist standardmäßig aktiviert; deaktivieren Sie es mit `channels.feishu.tools.drive: false` - -Das Tool `feishu_drive` stellt diese Kommentaraktionen bereit: - -| Aktion | Beschreibung | -| ---------------------- | --------------------------------------- | -| `list_comments` | Kommentare zu einem Dokument auflisten | -| `list_comment_replies` | Antworten in einem Kommentar-Thread auflisten | -| `add_comment` | Einen neuen Kommentar auf oberster Ebene hinzufügen | -| `reply_comment` | Auf einen vorhandenen Kommentar-Thread antworten | - -Wenn der Agent ein Drive-Kommentarereignis verarbeitet, erhält er: - -- den Kommentartext und den Absender -- Dokumentmetadaten (Titel, Typ, URL) -- den Kontext des Kommentar-Threads für Antworten im Thread - -Nach dem Vornehmen von Dokumentbearbeitungen wird der Agent angewiesen, `feishu_drive.reply_comment` zu verwenden, um den Kommentierenden zu benachrichtigen, und anschließend genau das stille Token `NO_REPLY` / `no_reply` auszugeben, um doppelte Sendungen zu vermeiden. - -## Runtime-Aktionsoberfläche - -Feishu stellt derzeit diese Runtime-Aktionen bereit: - -- `send` -- `read` -- `edit` -- `thread-reply` -- `pin` -- `list-pins` -- `unpin` -- `member-info` -- `channel-info` -- `channel-list` -- `react` und `reactions`, wenn Reaktionen in der Konfiguration aktiviert sind -- `feishu_drive`-Kommentaraktionen: `list_comments`, `list_comment_replies`, `add_comment`, `reply_comment` +--- ## Verwandt -- [Channels Overview](/channels) — alle unterstützten Kanäle -- [Pairing](/channels/pairing) — DM-Authentifizierung und Pairing-Ablauf -- [Groups](/channels/groups) — Verhalten in Gruppenchats und Mention-Gating -- [Channel Routing](/channels/channel-routing) — Sitzungsrouting für Nachrichten -- [Security](/gateway/security) — Zugriffsmodell und Härtung +- [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