飞书互动卡片工具，支持按钮、表单、投票等丰富交互，替代纯文本回复让用户一键选择，自动处理回调事件，提升协作效率与安全性。
说明：
## 核心功能
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 需携带完整状态以避免额外查询，卡片更新与异步任务需自行处理时序。
