Connect Lark (Feishu) messaging to OpenClaw via webhook bridge. Supports text, rich text (post), and image messages bidirectionally. Use when setting up Lark/Feishu as a messaging channel, receiving m
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Connect Lark (Feishu) to OpenClaw for bidirectional messaging with full rich content support.
# 1. Set credentials echo "FEISHU_APP_ID=cli_xxx" >> ~/.openclaw/workspace/.env mkdir -p ~/.openclaw/secrets echo "your_app_secret" > ~/.openclaw/secrets/feishu_app_secret2. Start bridge
cd skills/lark-integration/scripts node bridge-webhook.mjs
3. Configure Lark webhook URL in developer console
https://open.larksuite.com → Your App → Event Subscriptions
URL: http://YOUR_SERVER_IP:3000/webhook
Lark App ──webhook──► Bridge (port 3000) ──WebSocket──► OpenClaw Gateway │ │ ◄────────── Reply ──────────────────┘
| Type | Direction | Format |
|---|---|---|
| ↔ Both | Plain text |
| → Receive | Rich text with images, links |
| → Receive | Single image |
| Reply | ← Send | Text (cards via feishu-card skill) |
The bridge auto-detects platform from URLs:
*.larksuite.comhttps://open.larksuite.com*.feishu.cnhttps://open.feishu.cn| Variable | Required | Description |
|---|---|---|
| Yes | App ID from Lark Developer Console |
| No | Path to secret file (default: |
| No | Webhook listen port (default: 3000) |
| No | Delay before "Thinking..." placeholder (default: 2500) |
| No | Encryption key if enabled in Lark |
| No | Agent to route messages to (default: main) |
Enable these scopes in Lark Developer Console → Permissions & Scopes:
Messaging:
im:messageim:message:send_as_botim:resourceDocuments (optional):
docx:document:readonlywiki:wiki:readonlysheets:spreadsheet:readonlybitable:bitable:readonlydrive:drive:readonlyMain webhook bridge. Receives Lark events, forwards to OpenClaw, sends replies.
FEISHU_APP_ID=cli_xxx node scripts/bridge-webhook.mjs
Install as systemd service for auto-start:
node scripts/setup-service.mjs # Creates /etc/systemd/system/lark-bridge.service
Images in messages are:
postimagemessage_idimage_keyattachmentsattachments: [{ mimeType: "image/png", content: "<base64>" }]
In group chats, the bridge responds when:
?？Otherwise, messages are ignored to avoid noise.
Use the
feishu-docnode skills/feishu-doc/index.js fetch "https://xxx.larksuite.com/docx/TOKEN"
Supported URL types:
/docx//wiki//sheets//base/Permission Note: Documents must be shared with the bot, or the bot must have tenant-wide read permission.
docx:document:readonlycurl http://YOUR_IP:3000/healthjournalctl -u lark-bridge -fattachmentsim:resource# Check status systemctl status lark-bridgeView logs
journalctl -u lark-bridge -f
Restart
systemctl restart lark-bridge
references/api-formats.mdreferences/setup-guide.mdNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.