飞书交互卡片一键发送，告别纯文本

飞书互动卡片工具，支持按钮、表单、投票等丰富交互，替代纯文本回复让用户一键选择，自动处理回调事件，提升协作效率与安全性。

基本信息

• 技能名称?Feishu Interactive Cards
• 中文名称?飞书交互卡片一键发送，告别纯文本
• 作者?leecyang
• 分类?其他
• 版本?1.0.2
• 标签?feishu, lark, interactive-cards, chatbot, ui-components, webhook, enterprise-im, approval-workflow

使用方法

使用说明
核心功能
feishu-interactive-cards 是一套面向飞书（Lark）平台的交互式卡片解决方案，旨在替代传统的纯文本消息回复，通过按钮、表单、投票等富 UI 元素实现更直观的人机交互。
显著优点

1. 交互范式升级 ：强制遵循"任何不确定场景使用卡片"的设计原则，将用户从输入文字转为点击选择，大幅降低沟通成本与误操作风险。
2. 零部署成本 ：采用飞书长轮询（long-polling）模式，无需公网 IP 或服务器穿透，本地即可运行回调服务器，自动重连并对接 OpenClaw Gateway。
3. 开箱即用模板 ：内置确认对话框、待办清单、投票、表单四大模板，覆盖 90% 常见业务场景，支持 JSON 自定义扩展。
4. 安全设计内建 ：文档明确要求"绝不将用户输入直接传入 shell 命令"，强制使用 Node.js fs API、路径验证、事件去重（3s 窗口）等防护措施，并附带独立安全指南。
   潜在局限
   平台绑定 ：仅支持飞书生态，无法迁移至钉钉、企业微信等其他平台。
   Node.js 依赖 ：要求本地运行 Node 环境，对纯 Python 或其他语言栈用户增加维护成本。
   网络稳定性 ：长轮询模式虽免公网 IP，但在弱网环境下可能出现回调延迟或断连重连。
   适合人群
   使用 OpenClaw 框架构建飞书智能体的开发者
   需要将 AI Agent 与飞书 IM 深度集成的企业团队
   追求高交互体验、低误操作率的业务场景（审批、运维、客服等）
   常规风险
   回调服务单点故障 ：若 card-callback-server.js 未运行，按钮点击将无响应。
   权限配置疏漏 ：需确保飞书后台订阅 card.action.trigger 事件并配置正确凭证。
   状态管理复杂度 ：按钮 value 需携带完整状态以避免额外查询，卡片更新与异步任务需自行处理时序。