Agent skill · software engineering · sundial-org
feishu-bridge
Connect 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.
Why this skill is useful
Adds executable scripts for setting up a Feishu bot bridge with Clawdbot, including auto-start configurations and diagnostics.
What it needs
Requires npm installed locally. Requires open.feishu.cn account access. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Feishu Bridge Bridge Feishu bot messages to Clawdbot Gateway over local WebSocket. Architecture Feishu SDK connects outbound (no inbound port / public IP needed) Bridge authenticates to Gateway using the existing gateway token Each Feishu chat maps to a Clawdbot session (feishu:<chatId>) Setup 1. Create Feishu bot 1. Go to open.feishu.cn/app → Create self-built app → Add Bot capability 2. Enable permissions: im:message, im:message.groupatmsg, im:message.p2pmsg 3. Events: add im.message.receivev1, set delivery to WebSocket long-connection 4. Publish the app (create version → request approval) 5. Note the App ID and App Secret 2. Store secret 3. Install & run 4. Auto-start (macOS) Diagnostics Group chat behavior 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(). Environment variables Variable Required Default --- --- --- FEISHUAPPID ✅ — FEISHUAPPSECRETPATH — ~/.clawdbot/secrets/feishuappsecret CLAWDBOTCONFIGPATH — ~/.clawdbot/clawdbot.json CLAWDBOTAGENTID — main FEISHUTHINKINGTHRESHOLDMS — 2500
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/feishu-bridge