Feishu Image Webhook for Openclaw

A streamlined automation tool to upload local images to Feishu and broadcast them to group chats via webhooks.

imbing
v1.0.0
Mar 11, 2026
0
930
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install feishu-image-webhook

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-image-webhook 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 Image Webhook?

The Feishu Image Webhook skill is designed for developers and AI agents who need to bridge the gap between local file systems and Feishu (Lark) communication channels. By leveraging this tool within the Openclaw Skills ecosystem, users can programmatically handle the complex process of authenticating with Feishu, uploading media to obtain internal keys, and triggering bot webhooks to share visual data. It serves as a critical component for teams that rely on real-time visual updates and automated reporting within their primary chat workspace.

Feishu Image Webhook Use Cases

  • Automating the delivery of daily data visualization charts to management groups.
  • Sending system monitoring screenshots or error logs visually to DevOps channels.
  • Integrating with CI/CD pipelines to post build artifacts or test results as images.
  • Enabling AI agents to share generated visual content directly into team discussions using Openclaw Skills.

How Feishu Image Webhook Works

  1. The skill initializes by reading the specified local image path provided in the command argument.
  2. It authenticates with the Feishu platform using the stored App ID and App Secret to obtain an access token.
  3. The local image (JPG, PNG, or GIF) is uploaded to Feishu's servers, which returns a unique image_key.
  4. The script then constructs a JSON payload containing the image_key and sends a POST request to the configured Feishu group bot Webhook URL.
  5. The bot instantly displays the image in the target group chat for all members to see.

Feishu Image Webhook Setup

To integrate this functionality into your Openclaw Skills environment, follow these steps:

  1. Prepare your configuration file:
cp config.example.py config.py
  1. Update config.py with your Feishu Application credentials and Webhook URL:
APP_ID = "cli_xxx"
APP_SECRET = "xxx"
WEBHOOK_URL = "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
  1. Install the necessary Python dependencies:
pip install requests
  1. Execute the skill using the following command:
python send_image.py <path_to_image>

Feishu Image Webhook Data Schema & Taxonomy

The skill manages data through a local configuration file and interacts with the Feishu API schema:

Component Type Description
config.py Configuration Stores sensitive APP_ID, APP_SECRET, and WEBHOOK_URL.
image_key String A unique identifier generated by Feishu after an image upload.
Supported Formats File Types Validates and processes .jpg, .png, and .gif files.
API Permissions OAuth Requires the im:image permission scope within the Feishu Developer Console.

Feishu Image Webhook Advanced Features

  • Multi-format support including GIF for animated status updates.
  • Secure credential management by separating logic from sensitive configuration files.
  • Seamless integration for AI agents to provide visual feedback through Openclaw Skills.
  • Robust error handling for network requests and API authentication failures.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*