Feishu Cards

Send customizable interactive Feishu cards with titles, content, buttons, and color templates via Feishu Open API for users or group chats.

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