Skill

feishu-bridge

From sundial-org-awesome-openclaw-skills-4

Bridges Feishu (Lark) bots to Clawdbot Gateway via local WebSocket without public servers or ngrok. Guides bot creation, credential setup, bridge management (start/stop/logs), macOS launchd auto-restart, and group chat tuning.

Node

Install

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Bridge Feishu bot messages to Clawdbot Gateway over local WebSocket.

Supporting Assets

README.mdbridge.mjspackage.jsonsetup-service.mjs

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

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`