---
id: XiaomingX/moltbot-connector-feishu-dingtalk/feishu-connection
version: "f4fed230"
license: Apache-2.0
install: manual
updated: 2026-01-30
---

# 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.

Publisher: XiaomingX · Stars: 7 · Updated: 2026-01-30

Install (manual): `git clone https://github.com/XiaomingX/moltbot-connector-feishu-dingtalk`

## SKILL.md

# 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](https://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

| 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` |


[View on SkillFed](https://skillfed.io/XiaomingX/moltbot-connector-feishu-dingtalk/feishu-connection) · [View on GitHub](https://github.com/XiaomingX/moltbot-connector-feishu-dingtalk)