--- summary: "Every `channels.feishu` configuration key with its default" read_when: - Looking up a `channels.feishu` configuration key - Checking the default value of a Feishu setting title: "Feishu configuration reference" sidebarTitle: "Configuration reference" --- The full `channels.feishu` key list with defaults, plus the webhook path rules. ## Configuration reference Full configuration: [Gateway configuration](/gateway/configuration) | Setting | Description | Default | | -------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------ | | `channels.feishu.enabled` | Enable/disable the channel | `true` | | `channels.feishu.domain` | API domain (`feishu`, `lark`, or an `https://` base URL) | `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` | Canonical HTTP request path (must start with `/`) | `/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..replyToMode` | Per-account reply-reference mode | inherited | | `channels.feishu.accounts..tts` | Per-account TTS override | `tts` | | `channels.feishu.accounts..actions.sticker` | Per-account sticker action override | inherited | | `channels.feishu.dmPolicy` | DM policy (`pairing`, `allowlist`, `open`) | `pairing` | | `channels.feishu.allowFrom` | DM allowlist (open_id list) | - | | `channels.feishu.groupPolicy` | Group policy (`open`, `allowlist`, `disabled`) | `allowlist` | | `channels.feishu.groupAllowFrom` | Group allowlist | - | | `channels.feishu.groupSenderAllowFrom` | Sender allowlist applied to all groups | - | | `channels.feishu.requireMention` | Require @mention in groups | `true` (`false` when policy `open`) | | `channels.feishu.allowBots` | Accept other bots that mention this bot, with bot-loop protection | `false` | | `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.groups..allowFrom` | Per-group sender allowlist (overrides `groupSenderAllowFrom`) | - | | `channels.feishu.groupSessionScope` | Group session mapping (`group`, `group_sender`, `group_topic`, `group_topic_sender`) | `group` | | `channels.feishu.replyToMode` | Reply-reference mode (`off`, `first`, `all`, `batched`) | `all` | | `channels.feishu.replyInThread` | Bot replies create/continue topic threads (`disabled`, `enabled`) | `disabled` | | `channels.feishu.reactionNotifications` | Inbound reaction events (`off`, `own`, `all`) | `own` | | `channels.feishu.actions.sticker` | Enable received-sticker sending and configured sticker search | `false` | | `channels.feishu.stickerSets` | Searchable received-sticker keys and keywords, grouped by bot app ID | none | | `channels.feishu.vcAutoJoin` | Join invited VC meetings after normal DM authorization | `false` | | `channels.feishu.dynamicAgentCreation.enabled` | Enable automatic per-user agent creation | `false` | | `channels.feishu.dynamicAgentCreation.workspaceTemplate` | Path template for dynamic agent workspaces | `~/.openclaw/workspace-{agentId}` | | `channels.feishu.dynamicAgentCreation.agentDirTemplate` | Agent directory name template | `~/.openclaw/agents/{agentId}/agent` | | `channels.feishu.dynamicAgentCreation.maxAgents` | Maximum number of dynamic agents to create | unlimited | | `channels.feishu.textChunkLimit` | Message chunk size | `4000` | | `channels.feishu.streaming.chunkMode` | Chunk splitting (`length` or `newline`) | `length` | | `channels.feishu.mediaMaxMb` | Media size limit | `30` | | `channels.feishu.renderMode` | Reply rendering (`auto`, `raw`, `card`) | `auto` | | `channels.feishu.streaming.mode` | Streaming card output (`partial` or `off`) | `partial` | | `channels.feishu.streaming.block.enabled` | Completed-block reply streaming | `false` | | `channels.feishu.typingIndicator` | Send typing reactions | `true` | | `channels.feishu.resolveSenderNames` | Resolve sender display names | `true` | | `channels.feishu.configWrites` | Allow channel-initiated config writes (needed by dynamic agents) | `true` | | `channels.feishu.tools.doc` | Enable document tools | `true` | | `channels.feishu.tools.chat` | Enable chat info tools | `true` | | `channels.feishu.tools.wiki` | Enable knowledge base tools (requires `doc`) | `true` | | `channels.feishu.tools.drive` | Enable cloud storage tools | `true` | | `channels.feishu.tools.perm` | Enable permission management tools | `false` | | `channels.feishu.tools.scopes` | Enable app scopes diagnostic tool | `true` | | `channels.feishu.tools.bitable` | Enable Bitable/Base tools | `true` | | `channels.feishu.accounts..tools.bitable` | Per-account Bitable/Base tool gate | inherited | In webhook mode, both `channels.feishu.webhookPath` and `channels.feishu.accounts..webhookPath` must be canonical HTTP request paths beginning with `/`, such as `/feishu/events`. An optional query string is supported and must match exactly. Full URLs, relative paths, URL fragments, dot segments, and unencoded spaces or Unicode are rejected. If an existing configuration contains a noncanonical path, run `openclaw doctor --fix` to repair it before starting the gateway.