Files
picoclaw/docs/channels/feishu
Liqiang Lau 08f305d712 feat: add IsLark field to FeishuConfig to switch between Feishu and Lark domains (#1753)
* feat(feishu): add Lark (international) support via IsLark config field

Add IsLark field to FeishuConfig to switch between Feishu and Lark
domains. Also fix domain inconsistency where WS client defaulted to
LarkBaseUrl while HTTP client used FeishuBaseUrl.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: update documentation and web UI for Lark support

Add is_lark field to config example, feishu docs, i18n translations,
and web frontend form.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-19 00:29:55 +08:00
..

飞书

飞书(国际版名称:Lark)是字节跳动旗下的企业协作平台。它通过事件驱动的 Webhook 同时支持中国和全球市场。

配置

{
  "channels": {
    "feishu": {
      "enabled": true,
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": [],
      "is_lark": false
    }
  }
}
字段 类型 必填 描述
enabled bool 是否启用飞书频道
app_id string 飞书应用的 App ID(以cli_开头)
app_secret string 飞书应用的 App Secret
encrypt_key string 事件回调加密密钥
verification_token string 用于Webhook事件验证的Token
allow_from array 用户ID白名单,空表示所有用户
random_reaction_emoji array 随机添加的表情列表,空则使用默认 "Pin"
is_lark bool 是否使用 Lark 国际版域名(open.larksuite.com),默认为 false(使用飞书域名 open.feishu.cn

设置流程

  1. 前往 飞书开放平台(国际版用户请前往 Lark 开放平台)创建应用程序
  2. 获取 App ID 和 App Secret
  3. 配置事件订阅和Webhook URL
  4. 设置加密(可选,生产环境建议启用)
  5. 将 App ID、App Secret、Encrypt Key 和 Verification Token(如果启用加密) 填入配置文件中
  6. 自定义你希望 PicoClaw react 你消息时的表情(可选, Reference URL: Feishu Emoji List)