A robust webhook bridge that connects Lark or Feishu messaging platforms to OpenClaw for intelligent, bidirectional AI communication.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install lark-integration
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install lark-integration 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 Lark & Feishu Integration?
The Lark Integration skill is a sophisticated bridge designed to link the Lark (International) and Feishu (China) messaging ecosystems directly to your AI agents. By utilizing this within the Openclaw Skills framework, developers can enable AI agents to send and receive text, rich-text posts, and images seamlessly. The bridge handles the complexities of platform-specific API differences and authentication, providing a unified interface for your agents.
Beyond simple messaging, this skill allows AI agents to interact with the broader Lark suite, including documents, wikis, and bitables. It ensures that context is preserved across various media types, making it an essential tool for teams looking to embed AI capabilities directly into their primary communication and collaboration workspace.
Lark & Feishu Integration Use Cases
- Deploying a responsive AI assistant within corporate Lark or Feishu group chats.
- Automating document analysis and data retrieval from Lark wikis and bitables using Openclaw Skills.
- Processing image-based support tickets or queries directly from a mobile messaging interface.
- Building custom notification systems that allow for interactive AI-driven follow-ups.
- Facilitating cross-platform communication between internal tools and team messaging channels.
How Lark & Feishu Integration Works
- The Lark/Feishu platform triggers a webhook event when a user sends a message or @mentions the bot.
- The bridge service receives the HTTPS request and automatically detects the target platform (larksuite.com or feishu.cn).
- If the message contains images, the bridge uses the Lark API to download the resource and convert it to base64.
- The processed content is forwarded to the OpenClaw Gateway via a persistent WebSocket connection.
- The AI agent processes the input and generates a response, which is routed back through the bridge.
- The bridge translates the AI's output into the appropriate Lark message format (text or rich-text cards) and delivers it to the user.
Lark & Feishu Integration Setup
Prerequisites
Ensure you have your Lark or Feishu App ID and Secret ready from the developer console.
Installation
# 1. Configure environment variables
echo "FEISHU_APP_ID=cli_your_app_id" >> ~/.openclaw/workspace/.env
mkdir -p ~/.openclaw/secrets
echo "your_app_secret" > ~/.openclaw/secrets/feishu_app_secret
# 2. Launch the webhook bridge
cd skills/lark-integration/scripts
node bridge-webhook.mjs
# 3. Configure the Webhook URL in Lark Developer Console
# Navigate to: Your App -> Event Subscriptions
# Set URL to: http://<YOUR_SERVER_IP>:3000/webhook
Lark & Feishu Integration Data Schema & Taxonomy
The skill organizes data and configuration using the following structure:
| Component | Type | Description |
|---|---|---|
| Environment | .env | Stores FEISHU_APP_ID and port configurations |
| Secrets | File | Stores the sensitive feishu_app_secret securely |
| Payloads | JSON | Bidirectional mapping between Lark message types and OpenClaw attachments |
| Documents | URL | Supports docx, wiki, sheets, and base (bitable) formats |
| Services | Systemd | Optional lark-bridge.service for persistent background operation |
Lark & Feishu Integration Advanced Features
- Intelligent Group Chat Filtering: Only responds to @mentions, specific trigger keywords, or question-based patterns to reduce noise.
- Automatic Platform Detection: Switches dynamically between international Lark and Chinese Feishu API endpoints.
- Rich Media Handling: Automatically converts and attaches images as base64 for seamless processing by vision-enabled Openclaw Skills.
- Document Integration: Native support for reading and analyzing Lark/Feishu wikis and bitables via the
feishu-docextension. - Automated Service Management: Includes scripts to set up the bridge as a systemd service for high availability and logging.
SKILL.md
Loading
Related Openclaw Skills
Lark Calendar & Task Management
A powerful automation tool for managing Lark (Feishu) calendar events and tasks with built-in employee name resolution.
ListenHub
ListenHub is a powerful content transformation tool that converts text, URLs, and ideas into high-quality podcasts, explainer videos, and AI-generated imagery.
AIresearchOS
AIresearchOS is a deep research engine that enables users to submit complex queries and receive comprehensive, multi-source reports directly within an agent workflow.
Discord Chat
A comprehensive communication skill enabling AI agents to interact with Discord channels through messages, replies, reactions, and advanced history searching.
Feishu Agent
A versatile CLI tool for AI assistants to manage Feishu calendars, Bitable tasks, and organizational contacts.
Feishu Calendar Advanced
A powerful CLI-driven skill for managing Feishu (Lark) calendars with advanced features like event creation and conflict detection.
Featured*
