Skip to main content

​
Feishu/Lark

This is a shipped runtime-backed surface: direct sends are implemented, the serve loop is implemented, and the channel can join multi-channel-serve or gateway run.

​
At A Glance

FieldValue
Catalog idfeishu
Config keyfeishu
Implementation statusruntime_backed
Transportfeishu_openapi_webhook_or_websocket
Aliaseslark
Default send target kindreceive_id, message_reply

​
Minimal Config

[feishu]
enabled = true
domain = "lark"
mode = "websocket"
receive_id_type = "chat_id"
app_id_env = "FEISHU_APP_ID"
app_secret_env = "FEISHU_APP_SECRET"
allowed_chat_ids = ["oc_ops_room"]

​
Smoke Test

loong feishu-send --target "ou_xxxxxxxxxxxxx" --text "hello from loong"
loong feishu-serve

​
Command Surface

OperationCommandUsage or status
direct sendfeishu-sendUsage: loong feishu-send [OPTIONS] —target <TARGET>
inbound reply servicefeishu-serveUsage: loong feishu-serve [OPTIONS]

​
Required Fields For Send

RequirementConfig pathsEnv pointer pathsDefault env
channel enabledfeishu.enabled
feishu.accounts.<account>.enabled		nonenone
app idfeishu.app_id
feishu.accounts.<account>.app_id		feishu.app_id_env
feishu.accounts.<account>.app_id_env		FEISHU_APP_ID
app secretfeishu.app_secret
feishu.accounts.<account>.app_secret		feishu.app_secret_env
feishu.accounts.<account>.app_secret_env		FEISHU_APP_SECRET

​
Required Fields For Serve

RequirementConfig pathsEnv pointer pathsDefault env
channel enabledfeishu.enabled
feishu.accounts.<account>.enabled		nonenone
app idfeishu.app_id
feishu.accounts.<account>.app_id		feishu.app_id_env
feishu.accounts.<account>.app_id_env		FEISHU_APP_ID
app secretfeishu.app_secret
feishu.accounts.<account>.app_secret		feishu.app_secret_env
feishu.accounts.<account>.app_secret_env		FEISHU_APP_SECRET
serve modefeishu.mode
feishu.accounts.<account>.mode		nonenone
allowed chat idsfeishu.allowed_chat_ids
feishu.accounts.<account>.allowed_chat_ids		nonenone
verification token (webhook mode only)feishu.verification_token
feishu.accounts.<account>.verification_token		feishu.verification_token_env
feishu.accounts.<account>.verification_token_env		FEISHU_VERIFICATION_TOKEN
encrypt key (webhook mode only)feishu.encrypt_key
feishu.accounts.<account>.encrypt_key		feishu.encrypt_key_env
feishu.accounts.<account>.encrypt_key_env		FEISHU_ENCRYPT_KEY

​
Gateway And Ownership

This surface can run directly through its own *-serve command, or under Gateway And Supervision through multi-channel-serve and gateway run.

​
Operator Notes

  • Webhook mode additionally needs verification_token and encrypt_key; websocket mode does not.
  • Use allowed_chat_ids as the trust boundary instead of treating it as a convenience filter.
  • Keep domain = "lark" for the Lark lane and domain = "feishu" for the Feishu lane; the runtime contract is the same family.