feishu-connection_skill

This skill helps you connect Feishu bot to Clawdbot via WebSocket, manage bridge startup, logs, and group chat behavior.

Python

0

GitHub Stars

6

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill xiaomingx/moltbot-connector-feishu-dingtalk --skill feishu-connection

.env.example332 B
bridge.py12.2 KB
pyproject.toml253 B
README.md6.2 KB
setup_service.py2.3 KB
SKILL.md2.5 KB

Overview

This skill connects a Feishu (Lark) bot to Clawdbot via a local WebSocket long-connection so you can use Feishu as a messaging channel without exposing a public server or using ngrok. It handles Feishu bot creation, credential management, bridge startup, macOS launchd auto-restart, and group chat response tuning. Sessions are mapped per Feishu chat and the bridge authenticates to the gateway using your existing gateway token.

How this skill works

The local bridge runs a Feishu SDK client that maintains an outbound WebSocket to Feishu and a second WebSocket to the Clawdbot Gateway. Incoming Feishu events are translated to Clawdbot sessions (feishu:<chatId>) and forwarded; gateway responses are sent back into the original Feishu chat. Group chat reply rules and response thresholds are configurable in the bridge code and environment variables.

When to use it

Enable Feishu/Lark as a channel for Clawdbot without opening inbound ports or deploying a public server.
Set up a new Feishu bot and wire its events into Clawdbot using WebSocket long-connection.
Troubleshoot connectivity between Feishu and Clawdbot or review bridge logs.
Run the bridge on a local machine or server and use macOS launchd for auto-restart.
Adjust group chat reply behavior to avoid noisy or undesired bot replies.

Best practices

Store the Feishu App Secret in ~/.clawdbot/secrets with strict file permissions (600).
Set FEISHU_APP_ID environment variable before launching the bridge for predictable startup.
Use the provided launchd setup on macOS to auto-restart the bridge and capture stderr logs.
Tune should_respond_in_group() to match your organization’s mention and command patterns.
Monitor logs (~/.clawdbot/logs/feishu-bridge.err.log) and test approving the app version in Feishu Open Platform.

Example use cases

Connect an internal Feishu workspace to Clawdbot so employees can query an AI agent from group and 1:1 chats.
Deploy the bridge on a developer laptop or private server with no public IP and push messages securely to the gateway.
Adjust group reply rules so the bot only responds when explicitly asked or mentioned in project channels.
Automate bridge startup on macOS using launchd to ensure high availability for critical teams.

FAQ

No. The Feishu SDK uses an outbound WebSocket long-connection, so no public inbound port or ngrok is required.

How do I stop or check the bridge service on macOS?

Use launchctl: load/unload the ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist and view logs with tail -f ~/.clawdbot/logs/feishu-bridge.err.log.