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-cardsUsage
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_IDFEISHU_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*