Regional platforms
Feishu configuration reference
The full channels.feishu key list with defaults, plus the webhook path rules.
Configuration reference
Full 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.<id>.appId |
App ID | - |
channels.feishu.accounts.<id>.appSecret |
App Secret | - |
channels.feishu.accounts.<id>.domain |
Per-account domain override | feishu |
channels.feishu.accounts.<id>.replyToMode |
Per-account reply-reference mode | inherited |
channels.feishu.accounts.<id>.tts |
Per-account TTS override | tts |
channels.feishu.accounts.<id>.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.<chat_id>.requireMention |
Per-group @mention override; explicit IDs also admit the group in allowlist mode | inherited |
channels.feishu.groups.<chat_id>.enabled |
Enable/disable a specific group | true |
channels.feishu.groups.<chat_id>.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.<id>.tools.bitable |
Per-account Bitable/Base tool gate | inherited |
In webhook mode, both channels.feishu.webhookPath and
channels.feishu.accounts.<id>.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.
Was this useful?
