feishu-connection
feishu-connection establishes a WebSocket bridge between Feishu (Lark) bots and Clawdbot Gateway, eliminating the need for public infrastructure or ngrok tunnels. The skill handles bot registration on Feishu Open Platform, credential storage, bridge initialization, and optional macOS launchd auto-restart. Group chat responses can be tuned via configurable triggers like @-mentions, question marks, request verbs, or bot name references.
feishu-connection bridges Feishu bots to Clawdbot via local WebSocket without requiring public servers or ngrok.
AI-generated summary based on this skill's SKILL.md
Install
XiaomingX/moltbot-connector-feishu-dingtalk/feishu-connection · repository language: Python
git clone https://github.com/XiaomingX/moltbot-connector-feishu-dingtalk
cp -r moltbot-connector-feishu-dingtalk/skills/feishu-connection ~/.claude/skills/feishu-connectionFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I connect feishu to clawdbot?
feishu-connection establishes a WebSocket bridge between your Feishu bot and Clawdbot Gateway. Register your bot on Feishu Open Platform, store credentials locally, then initialize the bridge—no public server or ngrok tunnel required. The skill handles bot registration, credential management, and WebSocket connection setup automatically.
What is lark messaging integration websocket for feishu-connection?
feishu-connection uses a local WebSocket long-connection to route Feishu (Lark) messages directly to Clawdbot Gateway. This eliminates the need for public infrastructure, domain names, or reverse proxies. Messages flow bidirectionally through the secure WebSocket bridge maintained by the skill.
How do I configure feishu bot credentials and permissions?
feishu-connection stores bot credentials locally after you register on Feishu Open Platform. Configure IM message permissions, set group chat behavior triggers (@-mentions, question marks, request verbs, or bot name references), and tune response rules. The skill manages credential security and permission validation automatically.
Can feishu-connection enable macOS auto-restart?
Yes. feishu-connection supports optional macOS launchd auto-restart to manage the Feishu bridge service lifecycle. Enable auto-start on boot, monitor service status, and control start/stop operations. The skill integrates with macOS system services for seamless background operation.
How do I troubleshoot feishu bridge connection issues?
feishu-connection provides diagnostics through logs and service status checks. Review error logs for connection failures, credential mismatches, or permission issues. Verify WebSocket bridge initialization, check Feishu Open Platform bot settings, and confirm Clawdbot Gateway availability. The skill surfaces detailed diagnostics for rapid troubleshooting.
Does feishu-connection require a public server or domain?
No. feishu-connection operates entirely through local WebSocket without requiring public infrastructure, ngrok, or domain names. The bridge runs locally and connects directly to Clawdbot Gateway, making setup simpler and more secure for private deployments.
SKILL.md
rendered from the published skill — quoted content, verbatim
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
- 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
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 6 files
skills/feishu-connection/.env.example
skills/feishu-connection/README.md
skills/feishu-connection/SKILL.md
skills/feishu-connection/bridge.py
skills/feishu-connection/pyproject.toml
skills/feishu-connection/setup_service.py