A secure WebSocket bridge connecting Feishu (Lark) bots to local AI agents without requiring public servers or domain configurations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-bridge
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 feishu-bridge 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 Bridge?
The Feishu Bridge is a specialized connector designed to link Feishu (Lark) messaging bots with the Clawdbot Gateway. By leveraging WebSocket long-connections, this skill allows developers to deploy AI-driven bots within their organization's communication platform without the need for complex networking setups like ngrok, public IPs, or SSL certificates. This makes it an essential tool for teams looking to leverage Openclaw Skills within a secure, private environment.
The bridge ensures that every Feishu chat is mapped directly to a unique Clawdbot session using the feishu:chatId format. This maintains conversation context and allows the AI agent to interact seamlessly with users across direct messages and group chats, providing a robust interface for localized AI services.
Feishu Bridge Use Cases
- Deploying internal corporate AI assistants on Feishu/Lark without exposing local infrastructure to the public internet.
- Automating team workflows through group chat AI interactions powered by Openclaw Skills.
- Troubleshooting and managing the bridge service via local logs and macOS launchd.
- Testing AI agent behavior in a real-world messaging environment before production deployment.
How Feishu Bridge Works
- The Feishu SDK establishes an outbound WebSocket long-connection to the Feishu cloud, eliminating the need for inbound port forwarding.
- The bridge service authenticates with the Clawdbot Gateway using a pre-configured gateway token.
- When a user sends a message, Feishu pushes the event through the WebSocket to the local bridge script.
- The bridge processes the message, determines if a response is required based on group chat logic (mentions or keywords), and routes it to the AI agent.
- The agent's response is sent back through the bridge and delivered to the user via the Feishu platform.
Feishu Bridge Setup
First, create a self-built app on the Feishu Open Platform and enable Bot capabilities with message permissions (im:message, im:message.group_at_msg, im:message.p2p_msg). Ensure event delivery is set to WebSocket long-connection.
Next, store your app secret securely on your local machine:
mkdir -p ~/.clawdbot/secrets
echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret
chmod 600 ~/.clawdbot/secrets/feishu_app_secret
Install dependencies and start the bridge locally:
cd feishu-bridge
npm install
FEISHU_APP_ID=cli_xxx node bridge.mjs
For persistent operation on macOS, use the provided setup script to configure a launchd service for your Openclaw Skills integration:
FEISHU_APP_ID=cli_xxx node setup-service.mjs
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist
Feishu Bridge Data Schema & Taxonomy
The skill organizes its configuration and session data within the standard Clawdbot directory structure for consistent management across Openclaw Skills.
| Component | Path / Format | Description |
|---|---|---|
| App Secret | ~/.clawdbot/secrets/feishu_app_secret |
Securely stored Feishu credentials used for authentication. |
| Config File | ~/.clawdbot/clawdbot.json |
General bridge and agent configuration settings. |
| Session ID | feishu:<chatId> |
Mapping of Feishu chats to specific AI agent sessions. |
| Error Logs | ~/.clawdbot/logs/feishu-bridge.err.log |
Diagnostic output for monitoring the bridge service status. |
Feishu Bridge Advanced Features
- Intelligent group chat filtering that triggers responses only on @-mentions, specific punctuation like "?", or customizable request verbs.
- Automatic service recovery on macOS using launchd to ensure your Openclaw Skills bridge remains active after system restarts.
- Adjustable thinking thresholds via environment variables to manage bot "typing" status indicators during long AI processing tasks.
- Support for multiple agents by specifying the CLAWDBOT_AGENT_ID to route messages to different specialized models.
SKILL.md
Loading
Related Openclaw Skills
SEO Optimizer
A comprehensive SEO and compliance engine designed to optimize titles, keywords, and hashtags while scanning for prohibited Chinese advertising terms.
Content Writer - Chinese Social Media AI Generator
A multi-platform AI content generator designed to produce publish-ready Chinese social media posts with native formatting and hooks.
Content Rewriter
An AI agent skill designed to automatically repurpose and rewrite content for native formatting across major Chinese social media platforms.
Content Brainstorm
A high-performance AI engine for generating comprehensive 7-day social media content calendars with platform-native styling and SEO optimization.
Airdrop Hunter
Airdrop Hunter is an automated monitoring tool that tracks, analyzes, and alerts users to lucrative cryptocurrency airdrop opportunities.
Contract Scanner
A high-performance security tool for auditing Ethereum-based smart contracts to detect scams, honeypots, and hidden risks.
Featured*
