Feishu Card Sender 是一个专为飞书开放平台设计的自动化消息发送工具，核心功能是通过 OpenAPI 接口高效、稳定地推送交互式卡片消息。该工具避免了开发者每次手动编写 curl 命令的繁琐流程，提供统一的脚本入口 `scripts/send_feishu_card.py`，支持基于 JSON 模板的消息渲染与变量动态替换，极大提升了通知类消息的生成效率与可维护性。它采用 appid/appsecret 鉴权机制，不依赖 webhook 或 message 通道，确保消息推送的安全可控。此外，工具内置完善的凭证获取优先级体系，支持命令行参数、环境变量以及 OpenClaw 配置文件等多种方式注入敏感信息，兼顾灵活性与安全性。无论是向单个用户（open_id）还是群组（chat_id）发送结构化内容，Feishu Card Sender 都能快速响应，成为连接应用系统与飞书工作流的关键桥梁。
核心功能特点
- 基于飞书 OpenAPI 发送交互式卡片消息，无需手动编写 curl 请求
- 支持模板化 JSON 卡片与变量替换，提升消息复用性和维护效率
- 自动处理图片 URL 上传并注入 poster_img_key，简化媒体资源管理
- 灵活的凭证管理机制，支持命令行参数、环境变量及配置文件多种来源
- 内置模板列表与参数规范文档，降低使用门槛和配置错误风险
- 支持卡片回调自动路由与状态更新，实现订阅等交互操作的闭环处理
适用场景
Feishu Card Sender 特别适用于需要将结构化数据以美观卡片形式推送给用户的各类场景。例如，在 MoviePilot 等影视订阅系统中，当用户点击‘立即订阅’按钮后，系统可通过该工具自动向用户发送包含电影或剧集详情、演员阵容、海报等信息的互动卡片，增强用户体验。另一个典型用例是运维告警通知：当服务器异常或任务失败时，自动触发卡片消息，将关键指标、日志片段和操作建议整合进一张卡片，直接送达相关负责人的飞书会话中，确保信息触达率。此外，企业内部系统集成也受益匪浅——如审批流程完成、工单状态变更等事件，均可通过调用此脚本生成定制化卡片，避免传统文本消息的信息过载问题。由于支持 open_id 精准投递和 chat_id 群聊广播，无论是点对点沟通还是团队协同通知，都能精准覆盖目标受众。