🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Feishu Bridge
🦀 ClawHub

Feishu Bridge

by @alexanys

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.

Versionv1.0.0
Downloads10,752
Installs83
Stars⭐ 8
#legal
TERMINAL
clawhub install feishu-bridge

📖 About This Skill

name: feishu-bridge description: 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.

Feishu Bridge

Bridge Feishu bot messages to Clawdbot Gateway over local WebSocket.

Architecture

Feishu user → Feishu cloud ←WS→ bridge.mjs (local) ←WS→ Clawdbot Gateway → AI agent

  • 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:)

    • 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.group_at_msg, im:message.p2p_msg 3. Events: add im.message.receive_v1, 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

    mkdir -p ~/.clawdbot/secrets
echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret
chmod 600 ~/.clawdbot/secrets/feishu_app_secret

    3. Install & run

    cd /feishu-bridge
npm install
FEISHU_APP_ID=cli_xxx node bridge.mjs

    4. Auto-start (macOS)

    FEISHU_APP_ID=cli_xxx node setup-service.mjs
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

    Diagnostics

    # 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

    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 | |---|---|---| | 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 |

    ⚙️ Configuration

    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.group_at_msg, im:message.p2p_msg 3. Events: add im.message.receive_v1, 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

    mkdir -p ~/.clawdbot/secrets
echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret
chmod 600 ~/.clawdbot/secrets/feishu_app_secret

    3. Install & run

    cd /feishu-bridge
npm install
FEISHU_APP_ID=cli_xxx node bridge.mjs

    4. Auto-start (macOS)

    FEISHU_APP_ID=cli_xxx node setup-service.mjs
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist