feishu-bridgeConnect a Feishu (Lark) bot to Clawdbot via WebSocket long-connection. No public server, domain, or ngrok required. Use when setting up Feishu/Lark as a messaging channel, troubleshooting the Feishu bridge, or managing the bridge service (start/stop/logs). Covers bot creation on Feishu Open Platform, credential setup, bridge startup, macOS launchd auto-restart, and group chat behavior tuning.
Install via ClawdBot CLI:
clawdbot install AlexAnys/feishu-bridgeBridge Feishu bot messages to Clawdbot Gateway over local WebSocket.
Feishu user → Feishu cloud ←WS→ bridge.mjs (local) ←WS→ Clawdbot Gateway → AI agent
feishu:)im:message, im:message.group_at_msg, im:message.p2p_msgim.message.receive_v1, set delivery to WebSocket long-connectionmkdir -p ~/.clawdbot/secrets
echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret
chmod 600 ~/.clawdbot/secrets/feishu_app_secret
cd <skill-dir>/feishu-bridge
npm install
FEISHU_APP_ID=cli_xxx node bridge.mjs
FEISHU_APP_ID=cli_xxx node setup-service.mjs
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist
# Check service
launchctl list | grep feishu
# Logs
tail -f ~/.clawdbot/logs/feishu-bridge.err.log
# Stop
launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist
Bridge replies only when: user @-mentions the bot, message ends with ?/?, contains request verbs (帮/请/分析/总结…), or calls the bot by name. Customize the name list in bridge.mjs → shouldRespondInGroup().
| Variable | Required | Default |
|---|---|---|
| FEISHU_APP_ID | ✅ | — |
| FEISHU_APP_SECRET_PATH | — | ~/.clawdbot/secrets/feishu_app_secret |
| CLAWDBOT_CONFIG_PATH | — | ~/.clawdbot/clawdbot.json |
| CLAWDBOT_AGENT_ID | — | main |
| FEISHU_THINKING_THRESHOLD_MS | — | 2500 |
Generated Mar 1, 2026
A company uses the Feishu Bridge to connect their internal Feishu workspace with an AI agent for IT helpdesk support. Employees can ask questions about software issues, password resets, or system access directly in Feishu group chats, and the bot responds automatically based on predefined triggers like mentions or question marks, reducing IT ticket volume and response times.
An e-commerce business integrates the bridge to handle customer inquiries on Feishu, where they manage vendor and partner communications. The AI agent assists with order status updates, product information, and return policies in group chats, responding only when triggered by mentions or specific request verbs, streamlining support without manual intervention.
A project team uses the bridge to link Feishu with an AI agent for real-time project updates and task management. Team members can ask for progress reports, schedule meetings, or get reminders in Feishu chats, with the bot activating based on keywords like 'analyze' or 'help,' enhancing collaboration and reducing meeting overhead.
An online education provider deploys the bridge to connect Feishu with an AI tutoring agent. Students can ask homework questions or request explanations in Feishu study groups, and the bot responds when messages end with question marks or contain verbs like 'please explain,' providing instant academic support outside classroom hours.
A healthcare clinic uses the bridge to automate administrative tasks in Feishu, such as scheduling appointments or answering patient FAQs. Staff can interact with the AI agent in group chats, with the bot replying only on mentions or specific requests, improving efficiency and reducing administrative burden in a secure, local setup.
Offer the Feishu Bridge as part of a subscription-based service for businesses needing AI-powered messaging automation. Charge monthly fees per user or chat session, with tiers based on features like advanced triggers or custom integrations, generating recurring revenue from enterprises using Feishu for internal or customer communications.
Provide consulting services to help companies set up and customize the bridge for their specific use cases, such as IT support or customer service. Revenue comes from one-time setup fees, ongoing maintenance contracts, and training sessions, leveraging the skill's complexity to offer tailored solutions that ensure smooth integration with existing workflows.
License the bridge technology to other software vendors or agencies who rebrand it as part of their own AI messaging platforms. Generate revenue through licensing fees or revenue-sharing agreements, allowing partners to offer Feishu integration without developing the underlying infrastructure, expanding market reach through indirect sales channels.
💬 Integration Tip
Ensure the Feishu app has correct permissions and WebSocket events enabled before running the bridge, and test group chat triggers locally to avoid unexpected bot behavior in production environments.
iMessage/SMS CLI for listing chats, history, watch, and sending.
Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).