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:<chatId>
)
Setup
1. Create Feishu bot
- Go to open.feishu.cn/app → Create self-built app → Add Bot capability
- Enable permissions:
im:message
, im:message.group_at_msg
, im:message.p2p_msg
- Events: add
im.message.receive_v1
, set delivery to WebSocket long-connection
- Publish the app (create version → request approval)
- 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 <skill-dir>/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
|