feishu-connection

Original：🇺🇸 English
Translated
2 scriptsChecked / no sensitive code detected

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.

6installs
Sourcexiaomingx/moltbot-connector-feishu-dingtalk
Added on

NPX Install

npx skill4agent add xiaomingx/moltbot-connector-feishu-dingtalk feishu-connection

Tags

Translated version includes tags in frontmatter
feishu-botclawdbot-integrationwebsocket-connectionservice-managementmacos-auto-start

SKILL.md Content

View Translation Comparison →

Feishu Bridge

Bridge Feishu bot messages to Clawdbot Gateway over local WebSocket.

Architecture

Feishu user → Feishu cloud ←WS→ bridge.py (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

  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

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

3. Install & run

bash
cd <skill-dir>/feishu-connection
uv sync
FEISHU_APP_ID=cli_xxx uv run python bridge.py

4. Auto-start (macOS)

bash
FEISHU_APP_ID=cli_xxx uv run python setup_service.py
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

Diagnostics

bash
# 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.py
→ 
should_respond_in_group()
.

Environment variables

VariableRequiredDefault
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