Feishu Cards for Openclaw

A powerful tool for sending rich, interactive message cards to Feishu users and groups through the Feishu Open API.

seetherianbow
v1.0.0
Mar 3, 2026
0
1.2k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install feishu-cards

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install feishu-cards using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Feishu Cards?

Feishu Cards is a specialized utility designed for developers and teams who need to move beyond plain text notifications. By leveraging Openclaw Skills, users can programmatically dispatch beautifully formatted interactive cards that include headers, multi-colored templates, and functional buttons directly into Feishu chats.

This skill bridges the gap between automated workflows and user interaction by providing a structured way to present information. Whether you are using it as a standalone CLI tool or integrating it into a Python-based automation suite, this skill simplifies the complex Feishu message card JSON structure into easy-to-use commands. It is an essential addition to any developer's toolkit within the Openclaw Skills ecosystem for improving team engagement and operational visibility.

Feishu Cards Use Cases

  • Dispatching task notifications with actionable buttons like "Approve" or "Remind Me Later".
  • Sending system alerts with color-coded templates such as red for warnings or green for success.
  • Automating group chat announcements with rich formatting and metadata notes.
  • Building interactive bot responses that require structured user input via card buttons.
  • Integrating Feishu notifications into CI/CD pipelines or monitoring systems.

How Feishu Cards Works

  1. The user installs the skill and configures Feishu API credentials via environment variables.
  2. The user triggers the skill via CLI commands or calls the Python module with specific parameters such as recipient ID, title, and content.
  3. The skill processes the inputs and automatically constructs a valid Feishu interactive card JSON payload.
  4. It handles authentication with the Feishu Open API using the provided App ID and Secret.
  5. The formatted card is delivered to the specified user or group chat through the Openclaw Skills framework.

Feishu Cards Setup

First, install the skill via the hub:

clawhub install feishu-cards

Ensure you have the required Python library installed:

pip install requests

Configure your Feishu credentials as environment variables to enable API access:

export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"

Feishu Cards Data Schema & Taxonomy

The skill organizes message data into a structured format compatible with Feishu's interactive card system. Below is the metadata taxonomy used:

Attribute Description Values
to Recipient identifier open_id, user_id, or chat_id
template Header background color blue, green, red, yellow, grey
buttons Interactive elements Comma-separated list (CLI) or Array (Python)
note Footer information Plain text with icon support
content Message body Markdown-lite plain text

Feishu Cards Advanced Features

  • Multi-recipient support allowing targeting of individual users or entire group chats.
  • Dynamic button styling with automatic prioritization of primary (blue) and default (gray) types.
  • Support for custom footer notes to add context or timestamps to notifications.
  • Seamless Python module integration for building complex automation logic within Openclaw Skills.
  • Lightweight footprint requiring only the requests library for high-performance delivery.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*