Feishu Interactive Cards

💬 飞书交互卡片一键发送,自动回调

飞书交互卡片工具,支持按钮、表单、投票等富UI元素,自动处理回调,替代纯文本消息提升交互效率。

收藏
13.3k
安装
3.4k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Feishu Interactive Cards 是一个专为飞书(Lark)设计的交互卡片工具,核心理念是:当回复飞书消息且存在任何不确定性时,发送交互卡片而非纯文本。通过按钮、表单、投票等富UI元素,让用户通过点击而非输入来完成交互。

显著优点

1. 交互效率提升:用户通过点击按钮即可完成选择,无需手动输入,显著降低交互成本
2. 自动回调处理:内置长轮询回调服务器,无需公网IP即可接收用户交互事件

3. 多场景覆盖:支持确认对话框、待办清单、投票调查、表单收集等多种卡片模板

4. Agent原生集成:提供JavaScript SDK,方便在智能体中直接调用发送卡片

5. 状态自动携带:按钮value字段可携带完整状态信息,避免额外查询

潜在局限性

1. 外部依赖重:依赖飞书开放平台API和OpenClaw Gateway,任一服务异常都会影响功能
2. 配置复杂度高:需要正确配置appId/appSecret、网关token等多项参数

3. 本地服务依赖:回调服务器需本地持续运行,断开后无法接收交互事件

4. 仅支持飞书生态:无法迁移至其他IM平台(如钉钉、企业微信)

适合人群

  • 构建飞书办公自动化(OA)系统的开发者
  • 需要人机交互确认环节的企业AI Agent项目
  • 飞书企业用户中的IT管理员和技术团队

常规风险

  • 凭证泄露风险:appSecret和gateway token需妥善保管
  • 长轮询稳定性:网络波动可能导致回调接收中断
  • 用户体验一致性:过度使用卡片可能造成界面臃肿

Feishu Interactive Cards 内容

examples文件夹
references文件夹
scripts文件夹
手动下载zip · 26.1 kB
confirmation-card.jsonapplication/json
请选择文件