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 messages with images, sending replies back to Lark, reading Lark documents/wikis/bitables, or troubleshooting Lark integration issues. Covers both Lark International (larksuite.com) and China Feishu (feishu.cn).
数据来源：ClawHub。 在 ClawSkills 查看
选择你使用的 Agent
方法一：命令行安装（推荐）
推荐（无需提前安装 clawhub）
npx clawhub@latest --dir ~/.claude/skills install lark-integration或使用 clawhub CLI（需提前安装）
clawhub --dir ~/.claude/skills install lark-integration⚠️ 需要 Node.js 18+，没有 Node？请使用下方方法二直接下载 ZIP。 安装 Node.js →
方法二：手动下载安装（无需 Node）
下载 ZIP，解压后将文件夹放到以下路径，重启 Agent 即可：
安装路径
~/.claude/skills/lark-integration/💡解压后将文件夹放到上方路径，重启 Agent 即可生效
--- name: lark-integration description: 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 messages with images, sending replies back to Lark, reading Lark documents/wikis/bitables, or troubleshooting Lark integration issues. Covers both Lark International (larksuite.com) and China Feishu (feishu.cn). ---
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_secret
# 2. 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/webhookLark App ──webhook──► Bridge (port 3000) ──WebSocket──► OpenClaw Gateway
│ │
◄────────── Reply ──────────────────┘| Type | Direction | Format | |------|-----------|--------| | text | ↔ Both | Plain text | | post | → Receive | Rich text with images, links | | image | → Receive | Single image | | Reply | ← Send | Text (cards via feishu-card skill) |
The bridge auto-detects platform from URLs:
*.larksuite.com → https://open.larksuite.com (International)*.feishu.cn → https://open.feishu.cn (China)| Variable | Required | Description | |----------|----------|-------------| | FEISHU_APP_ID | Yes | App ID from Lark Developer Console | | FEISHU_APP_SECRET_PATH | No | Path to secret file (default: ~/.openclaw/secrets/feishu_app_secret) | | WEBHOOK_PORT | No | Webhook listen port (default: 3000) | | FEISHU_THINKING_THRESHOLD_MS | No | Delay before "Thinking..." placeholder (default: 2500) | | FEISHU_ENCRYPT_KEY | No | Encryption key if enabled in Lark | | OPENCLAW_AGENT_ID | No | Agent to route messages to (default: main) |
Enable these scopes in Lark Developer Console → Permissions & Scopes:
Messaging:
im:message - Send and receive messagesim:message:send_as_bot - Send messages as botim:resource - Download message resources (images)Documents (optional):
docx:document:readonly - Read documentswiki:wiki:readonly - Read wiki spacessheets:spreadsheet:readonly - Read spreadsheetsbitable:bitable:readonly - Read bitablesdrive:drive:readonly - Access drive filesMain webhook bridge. Receives Lark events, forwards to OpenClaw, sends replies.
FEISHU_APP_ID=cli_xxx node scripts/bridge-webhook.mjsInstall as systemd service for auto-start:
node scripts/setup-service.mjs
# Creates /etc/systemd/system/lark-bridge.serviceImages in messages are:
post content or image message typemessage_id and image_keyattachments parameterattachments: [{ mimeType: "image/png", content: "<base64>" }]In group chats, the bridge responds when:
? or ？Otherwise, messages are ignored to avoid noise.
Use the feishu-doc skill to read Lark documents:
node skills/feishu-doc/index.js fetch "https://xxx.larksuite.com/docx/TOKEN"Supported URL types:
/docx/ - New documents/wiki/ - Wiki pages (auto-resolves to underlying doc)/sheets/ - Spreadsheets/base/ - Bitables (multi-dimensional tables)Permission Note: Documents must be shared with the bot, or the bot must have tenant-wide read permission.
docx:document:readonly in consolecurl http://YOUR_IP:3000/healthjournalctl -u lark-bridge -fattachments for imagesim:resource scope → Enable in Lark console# Check status
systemctl status lark-bridge
# View logs
journalctl -u lark-bridge -f
# Restart
systemctl restart lark-bridgereferences/api-formats.md for message format detailsreferences/setup-guide.md for step-by-step setup安装 Lark Integration 后，可以对 AI 说这些话来触发它
Send a Slack message to the #engineering channel about the deployment
Formats and sends the message with relevant context, tagging the right people
Summarize all unread messages in my inbox from today
Reads messages across connected channels and returns a prioritized summary
Draft a reply to this customer complaint and send it for review
Writes an empathetic, professional response and routes it to the approval queue
将技能文件夹放到 ~/.claude/skills/lark-integration/ 目录（个人级，所有项目可用），或 .claude/skills/lark-integration/（项目级）。重启 AI 客户端后，用 /lark-integration 主动调用，或让 AI 根据上下文自动发现并使用。
Lark Integration 支持 Claude、Cursor、OpenClaw，可与这些 AI 平台无缝集成，扩展其能力。
Lark Integration 可免费安装使用。请查阅仓库了解许可证信息。
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 messages with images, sending replies back to Lark, reading Lark documents/wikis/bitables, or troubleshooting Lark integration issues. Covers both Lark International (larksuite.com) and China Feishu (feishu.cn).
Lark Integration 属于「Communication」分类，该分类的技能帮助 AI 智能体在此领域执行专业任务。