核心用法
Feishu Cards 是一款面向开发者和运维团队的飞书消息推送工具，通过调用飞书开放 API 实现交互式卡片的发送。支持两种使用模式：
CLI 命令行模式：通过 feishu-cards 命令快速发送卡片，支持指定接收者（用户或群组）、标题、内容、交互按钮及颜色模板。典型场景如定时任务完成通知、CI/CD 构建结果推送。
Python 模块模式：集成至现有 Python 项目，使用 FeishuCardSender 类程序化发送消息，便于与业务系统深度整合。
核心特性：
- 五种预设颜色模板（blue/green/red/yellow/grey），适配不同消息类型
- 交互按钮支持，首按钮为 primary 样式（蓝色），其余为 default（灰色）
- 双模式 ID 支持：open_id（默认）、user_id、chat_id
- 可选备注字段，用于附加信息
显著优点
1. 极低接入成本：一行命令即可完成安装与发送，无需理解飞书卡片 JSON 协议细节
2. 开箱即用：默认继承 OpenClaw 配置的飞书应用凭证，零配置启动；同时支持环境变量自定义
3. 格式专业：相比纯文本通知，卡片式消息视觉层级清晰，提升信息阅读效率
4. 双向灵活：既满足脚本自动化需求，也支持代码集成场景
潜在缺点与局限性
- 交互能力受限：按钮仅支持打开 URL，需自建回调服务器才能实现表单提交、数据回传等完整交互
- 内容格式单一：正文仅支持纯文本，不支持 Markdown 或富文本嵌套
- 体积限制：单卡片上限 45KB，复杂内容需裁剪
- 生态依赖：深度绑定飞书生态，无法迁移至其他 IM 平台
适合人群
- 运维工程师：服务器监控告警、定时任务状态通知
- 开发者：CI/CD 流水线结果推送、代码审查提醒
- 团队管理员：群发公告、活动通知（需配合 chat_id）
常规风险
- 凭证泄露风险：
FEISHU_APP_ID与FEISHU_APP_SECRET若硬编码或日志泄露，可能导致消息滥用 - ID 误用风险：混淆 open_id 与 user_id 或 chat_id 会导致消息发送失败或误发
- 频率限制：未明确说明但飞书 API 存在调用配额，高频场景需关注限流
- 按钮链接安全：若按钮 URL 指向外部站点，存在钓鱼链接风险，需确保 URL 可信