From f296f1cbb375a31a5a39e15d1d6a7ede14bc7350 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Mon, 27 Apr 2026 20:58:05 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@18ef83c0da37f7a1747f0b2f3371728dddb9dfb7 --- .openclaw-sync/source.json | 4 +- docs/channels/feishu.md | 83 +++++++++++++++++++++++--------------- 2 files changed, 52 insertions(+), 35 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 602712119..73e0e3c23 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "b6be42230672ea2983cbec204217bd2cd7b255a0", - "syncedAt": "2026-04-27T20:38:17.681Z" + "sha": "18ef83c0da37f7a1747f0b2f3371728dddb9dfb7", + "syncedAt": "2026-04-27T20:56:32.395Z" } diff --git a/docs/channels/feishu.md b/docs/channels/feishu.md index 628236ce6..3b93283e8 100644 --- a/docs/channels/feishu.md +++ b/docs/channels/feishu.md @@ -59,11 +59,11 @@ openclaw pairing approve feishu **Group policy** (`channels.feishu.groupPolicy`): -| Value | Behavior | -| ------------- | ------------------------------------------ | -| `"open"` | Respond to all messages in groups | -| `"allowlist"` | Only respond to groups in `groupAllowFrom` | -| `"disabled"` | Disable all group messages | +| Value | Behavior | +| ------------- | -------------------------------------------------------------------------------------------- | +| `"open"` | Respond to all messages in groups | +| `"allowlist"` | Only respond to groups in `groupAllowFrom` or explicitly configured under `groups.` | +| `"disabled"` | Disable all group messages | Default: `allowlist` @@ -117,6 +117,23 @@ Default: `allowlist` } ``` +You can also admit a group by adding an explicit `groups.` entry. Wildcard defaults under `groups.*` configure matching groups, but they do not admit groups by themselves. + +```json5 +{ + channels: { + feishu: { + groupPolicy: "allowlist", + groups: { + oc_xxx: { + requireMention: false, + }, + }, + }, + }, +} +``` + ### Restrict senders within a group ```json5 @@ -386,34 +403,34 @@ See [Get group/user IDs](#get-groupuser-ids) for lookup tips. Full configuration: [Gateway configuration](/gateway/configuration) -| Setting | Description | Default | -| ------------------------------------------------- | ------------------------------------------ | ---------------- | -| `channels.feishu.enabled` | Enable/disable the channel | `true` | -| `channels.feishu.domain` | API domain (`feishu` or `lark`) | `feishu` | -| `channels.feishu.connectionMode` | Event transport (`websocket` or `webhook`) | `websocket` | -| `channels.feishu.defaultAccount` | Default account for outbound routing | `default` | -| `channels.feishu.verificationToken` | Required for webhook mode | — | -| `channels.feishu.encryptKey` | Required for webhook mode | — | -| `channels.feishu.webhookPath` | Webhook route path | `/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` | Per-account domain override | `feishu` | -| `channels.feishu.accounts..tts` | Per-account TTS override | `messages.tts` | -| `channels.feishu.dmPolicy` | DM policy | `allowlist` | -| `channels.feishu.allowFrom` | DM allowlist (open_id list) | [BotOwnerId] | -| `channels.feishu.groupPolicy` | Group policy | `allowlist` | -| `channels.feishu.groupAllowFrom` | Group allowlist | — | -| `channels.feishu.requireMention` | Require @mention in groups | `true` | -| `channels.feishu.groups..requireMention` | Per-group @mention override | inherited | -| `channels.feishu.groups..enabled` | Enable/disable a specific group | `true` | -| `channels.feishu.textChunkLimit` | Message chunk size | `2000` | -| `channels.feishu.mediaMaxMb` | Media size limit | `30` | -| `channels.feishu.streaming` | Streaming card output | `true` | -| `channels.feishu.blockStreaming` | Block-level streaming | `true` | -| `channels.feishu.typingIndicator` | Send typing reactions | `true` | -| `channels.feishu.resolveSenderNames` | Resolve sender display names | `true` | +| Setting | Description | Default | +| ------------------------------------------------- | -------------------------------------------------------------------------------- | ---------------- | +| `channels.feishu.enabled` | Enable/disable the channel | `true` | +| `channels.feishu.domain` | API domain (`feishu` or `lark`) | `feishu` | +| `channels.feishu.connectionMode` | Event transport (`websocket` or `webhook`) | `websocket` | +| `channels.feishu.defaultAccount` | Default account for outbound routing | `default` | +| `channels.feishu.verificationToken` | Required for webhook mode | — | +| `channels.feishu.encryptKey` | Required for webhook mode | — | +| `channels.feishu.webhookPath` | Webhook route path | `/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` | Per-account domain override | `feishu` | +| `channels.feishu.accounts..tts` | Per-account TTS override | `messages.tts` | +| `channels.feishu.dmPolicy` | DM policy | `allowlist` | +| `channels.feishu.allowFrom` | DM allowlist (open_id list) | [BotOwnerId] | +| `channels.feishu.groupPolicy` | Group policy | `allowlist` | +| `channels.feishu.groupAllowFrom` | Group allowlist | — | +| `channels.feishu.requireMention` | Require @mention in groups | `true` | +| `channels.feishu.groups..requireMention` | Per-group @mention override; explicit IDs also admit the group in allowlist mode | inherited | +| `channels.feishu.groups..enabled` | Enable/disable a specific group | `true` | +| `channels.feishu.textChunkLimit` | Message chunk size | `2000` | +| `channels.feishu.mediaMaxMb` | Media size limit | `30` | +| `channels.feishu.streaming` | Streaming card output | `true` | +| `channels.feishu.blockStreaming` | Block-level streaming | `true` | +| `channels.feishu.typingIndicator` | Send typing reactions | `true` | +| `channels.feishu.resolveSenderNames` | Resolve sender display names | `true` | ---