feishu-bridge

Bridge Feishu messages to the Clawdbot Gateway over a local WebSocket connection.

318|37|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/AlexAnys/feishu-openclaw --skill feishu-bridge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-bridge
Source: https://github.com/AlexAnys/feishu-openclaw/tree/main
Command: npx skills add https://github.com/AlexAnys/feishu-openclaw --skill feishu-bridge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a lightweight, serverless bridge between Feishu/Lark bots and the Clawdbot Gateway running locally, enabling real-time messaging without public servers.

Core Features & Use Cases

  • Local Feishu bridge over WebSocket connects Feishu bot to Clawdbot Gateway.
  • No public server or domain required, making it suitable for on-device or private deployments.
  • Use cases include troubleshooting the Feishu bridge, managing bridge startup/shutdown/logs, and using Feishu as a messaging channel to Clawdbot.

Quick Start

Set FEISHU_APP_ID to your Feishu App ID, store the App Secret at the default path ~/.clawdbot/secrets/feishu_app_secret, install dependencies, and run the bridge.mjs with the FEISHU_APP_ID environment variable to start bridging Feishu messages to Clawdbot.

Frequently Asked Questions about feishu-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bridge Feishu messages to a local bot without a public server?

You can bridge Feishu messages locally by running a WebSocket connection to the Clawdbot Gateway. This bypasses the need for a public server or domain, routing real-time Feishu bot messages directly through your local machine.

Do I need Node.js to connect a Feishu bot to Clawdbot?

Yes, connecting a Feishu bot to Clawdbot requires Node.js version 18 or higher. You also need to configure your Feishu App ID and store the App Secret in a local file path.

How does the Feishu WebSocket gateway handle local bot credentials?

The Feishu WebSocket gateway uses local credentials by reading the FEISHU_APP_ID environment variable and loading the App Secret from a designated local file path, ensuring authentication without exposing secrets publicly.

What is the best way to troubleshoot a Feishu bot bridge on macOS?

To troubleshoot a Feishu bot bridge on macOS, use this Skill to manage the bridge startup, shutdown, and logs. It helps identify connection issues between the Feishu bot and the local Clawdbot Gateway.

Can I use Feishu as a messaging channel for Clawdbot without public deployment?

Yes, you can use Feishu as a messaging channel for Clawdbot without public deployment. The bridge operates entirely over a local WebSocket, making it suitable for private or on-device environments.

Why does the Feishu bridge require an App Secret file path?

The Feishu bridge requires an App Secret file path to securely load your bot credentials locally. By storing the secret at a specified path instead of inline, the bridge maintains security during the WebSocket authentication process.