核心功能
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 需携带完整状态以避免额外查询，卡片更新与异步任务需自行处理时序。