SkillHub

feishu-cards

v1.0.0

通过飞书开放API向用户或群聊发送可自定义的交互式卡片，支持配置标题、内容、按钮及颜色模板。

Sourced from ClawHub, Authored by SeeTheRainBow

Installation

Please help me install the skill `feishu-cards` from SkillHub official store. npx skills add SeeTheRianBow/feishu-cards

Feishu Cards

Send interactive cards to Feishu (飞书) directly via Feishu Open API.

When to Use

  • User wants to send rich interactive messages in Feishu
  • Need buttons, forms, or dropdown menus in messages
  • Want beautifully formatted messages with colors

Installation

clawhub install feishu-cards

Usage

CLI

# Basic card
feishu-cards --to "ou_xxx" --title "标题" --content "内容"

# With buttons
feishu-cards --to "ou_xxx" --title "任务" --content "有新任务" --buttons "处理,稍后"

# Custom color
feishu-cards --to "ou_xxx" --title "警告" --content "注意" --template "red"

# To chat
feishu-cards --to "oc_xxx" --type "chat_id" --title "群通知" --content "大家好"

As Python Module

from feishu_card_sender import FeishuCardSender

sender = FeishuCardSender()
result = sender.send(
    recipient_id="ou_xxx",
    title="任务提醒",
    content="你有一个新任务",
    buttons=["立即处理", "稍后提醒"],
    template="blue"
)

Options

Flag Description Default
--to Recipient ID (user or chat) Required
--type ID type: open_id, user_id, chat_id open_id
--title Card title Required
--content Card content text Required
--buttons Comma-separated buttons None
--template Color: blue, green, red, yellow, grey blue
--note Optional note None

Card Elements

  • Header - Title with color template
  • Content - Main text (plain text format)
  • Buttons - Interactive buttons (primary/default types)
  • Note - Additional info with icon

Button Types

  • primary - Blue button (first button)
  • default - Gray button (other buttons)

Examples

Task Notification

python3 feishu_card_sender.py 
  --to "ou_9d00de9a95a2fb69c425f0a39930c67a" 
  --title "📋 任务通知" 
  --content "你有一个新任务待处理" 
  --buttons "立即处理,稍后提醒" 
  --template "blue"

Alert Card

python3 feishu_card_sender.py 
  --to "ou_xxx" 
  --title "⚠️ 警告" 
  --content "账户存在异常登录" 
  --template "red" 
  --buttons "查看详情"

Requirements

  • Python 3.7+
  • requests library

Install: pip install requests

Configuration

Credentials are read from environment variables (optional): - FEISHU_APP_ID - FEISHU_APP_SECRET

Defaults to OpenClaw's configured Feishu app.

Notes

  • Cards work in Direct Messages and group chats
  • Buttons open URLs (configure your callback server for full interactivity)
  • Maximum card size: 45KB

Made for ClawHub