跳到主要内容

Feishu

feishu channel 通过 WebSocket 与飞书服务器建立长连接,接收机器人事件并回复消息。无需暴露公网 IP,只需配置好应用凭证即可使用。

支持的功能

  • WebSocket 长连接接收飞书事件
  • 无需公网 IP
  • 文本消息回复

快速开始

  1. 创建飞书应用

    前往飞书开放平台,创建一个企业自建应用。

  2. 配置机器人能力

    在应用中添加机器人能力,并配置消息事件订阅。

  3. 获取凭证

    获取 App IDApp Secret

  4. 配置验证和加密

    如果启用了事件加密,需要配置 verification_tokenencrypt_key

  5. 配置 MushroomAgent

    设置环境变量或配置文件启用飞书 channel。

配置

channels:
feishu:
enabled: true
app_id: "cli_xxx"
app_secret: "xxx"
verification_token: "xxx"
encrypt_key: "xxx"

环境变量:

  • FEISHU_APP_ID
  • FEISHU_APP_SECRET
  • FEISHU_VERIFICATION_TOKEN
  • FEISHU_ENCRYPT_KEY

权限要求

在飞书开放平台配置以下权限:

  • im:message - 读取和发送消息

适用场景

  • 飞书群机器人
  • 飞书私聊助手
  • 企业内部知识问答和流程机器人