Skills feishu-bridge

Name: feishu-bridge
Author: openclaw

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.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/alexanys/feishu-bridge" ~/.claude/skills/openclaw-skills-feishu-bridge && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/alexanys/feishu-bridge" ~/.openclaw/skills/openclaw-skills-feishu-bridge && rm -rf "$T"

manifest: skills/alexanys/feishu-bridge/SKILL.md

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`