← Back to Skills Marketplace
Feishu Cards
by
SeeTheRainBow
· GitHub ↗
· v1.0.0
479
Downloads
0
Stars
6
Active Installs
1
Versions
Install in OpenClaw
/install feishu-cards
Description
Send customizable interactive Feishu cards with titles, content, buttons, and color templates via Feishu Open API for users or group chats.
README (SKILL.md)
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_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
Usage Guidance
This skill appears to do what it says (send Feishu interactive cards) but it includes an embedded FEISHU_APP_ID and FEISHU_APP_SECRET in the source. Before installing, do the following: 1) Treat the embedded secret as a red flag — ask the publisher who owns that app/secret and whether it's intended for public use. 2) Prefer to set your own FEISHU_APP_ID and FEISHU_APP_SECRET in environment variables; do not rely on the embedded defaults. 3) If you cannot verify the embedded credentials' owner, remove or overwrite them in the code before use. 4) Audit button URLs and any callback server you configure to avoid linking to malicious endpoints. 5) Consider running the sender in a sandbox or test Feishu account first to observe behavior. If you need help verifying the origin of the credentials or modifying the code to remove defaults, get developer assistance.
Capability Analysis
Type: OpenClaw Skill
Name: feishu-cards
Version: 1.0.0
The skill bundle appears benign. It provides functionality to construct and send interactive Feishu cards using the official Feishu Open API. The `SKILL.md` contains no prompt injection attempts. The Python scripts (`feishu_card_sender.py` and `feishu_cards.py`) primarily handle card JSON construction and legitimate API calls to `open.feishu.cn`. While `feishu_card_sender.py` includes hardcoded default `FEISHU_APP_ID` and `FEISHU_APP_SECRET`, these are explicitly stated as defaults for 'OpenClaw's configured Feishu app' and are not used for exfiltration or unauthorized access to other systems. There is no evidence of data exfiltration, malicious execution, persistence, or obfuscation with harmful intent.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md and the two Python modules all consistently implement Feishu card construction and sending. The required capabilities (HTTP requests to Feishu APIs) match the stated purpose. However the repository includes a hard-coded APP_ID and APP_SECRET used as defaults, which is surprising because the registry metadata lists no primary credential and the SKILL.md only describes optional env vars. That mismatch is noteworthy.
Instruction Scope
SKILL.md and the code instruct the agent to build and POST Feishu interactive card JSON to Feishu endpoints. The runtime instructions do not tell the agent to read arbitrary user files or other unrelated environment variables, nor to transmit local data to unknown third-party endpoints. Button callbacks may open external URLs (the simple sender builds example.com links), and SKILL.md warns that a callback server is needed for full interactivity.
Install Mechanism
There is no install spec that downloads external artifacts; this is effectively instruction + included source code. No external archives or installers are fetched during install, lowering installation risk.
Credentials
SKILL.md documents two optional environment variables (FEISHU_APP_ID and FEISHU_APP_SECRET). But feishu_card_sender.py contains hard-coded defaults (APP_ID and APP_SECRET values embedded in source). That creates a hidden credential default: if the user does not set env vars, the skill will use the embedded credentials to call Feishu on the user's behalf. The registry metadata did not declare a primary credential. Hard-coded secrets in published code are a security and provenance concern and may result in unexpected message sending under someone else's app.
Persistence & Privilege
Skill is not always:true and does not request persistent system-wide configuration changes. It doesn't modify other skills or agent-wide settings and has no special OS privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-cards - After installation, invoke the skill by name or use
/feishu-cards - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of feishu-cards.
- Send interactive, richly formatted cards to Feishu users or chats using the Feishu Open API.
- Supports buttons, forms, dropdown menus, customizable colors, and notes in message cards.
- Provides both CLI and Python module interfaces.
- Flexible configuration via flags and environment variables.
- Example usage and installation instructions included.
Metadata
Frequently Asked Questions
What is Feishu Cards?
Send customizable interactive Feishu cards with titles, content, buttons, and color templates via Feishu Open API for users or group chats. It is an AI Agent Skill for Claude Code / OpenClaw, with 479 downloads so far.
How do I install Feishu Cards?
Run "/install feishu-cards" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Feishu Cards free?
Yes, Feishu Cards is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Feishu Cards support?
Feishu Cards is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Feishu Cards?
It is built and maintained by SeeTheRainBow (@seetherianbow); the current version is v1.0.0.
More Skills