飞书消息桥接

技能简介

本技能通过 Webhook 桥接飞书（Lark/Feishu）与 OpenClaw，实现双向消息传输。支持纯文本、富文本（含图片、链接）及单张图片的收发，覆盖国际版 Lark 与中国版飞书双平台。

能做什么

• 接收飞书私聊或群聊消息，转发至 OpenClaw 处理
• 将 OpenClaw 回复发送回飞书对话
• 自动下载并编码消息中的图片为 base64 附件
• 识别群聊中 @机器人、疑问句或触发词，避免无关干扰
• 配合 feishu-doc 技能读取飞书文档、表格、知识库

使用说明

1. 配置凭证

echo "FEISHU_APP_ID=cli_xxx" >> ~/.openclaw/workspace/.env
mkdir -p ~/.openclaw/secrets
echo "your_app_secret" > ~/.openclaw/secrets/feishu_app_secret

2. 启动桥接服务

cd skills/lark-integration/scripts
node bridge-webhook.mjs

3. 配置飞书 Webhook

登录 Lark 开发者后台 → 你的应用 → 事件订阅 → 填写 URL：http://YOUR_SERVER_IP:3000/webhook

4. 安装为系统服务（可选）

node scripts/setup-service.mjs
systemctl start lark-bridge

输入与输出

风险提示

• App Secret 需妥善保管，避免硬编码提交至代码仓库
• Webhook 端口默认 3000，生产环境建议配置防火墙与 HTTPS 反向代理
• 文档读取需单独授权，未共享文档会返回 forBidden 错误
• 图片下载依赖 im:resource 权限，缺失时图片内容无法获取

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/boyangwang/lark-integration/SKILL.md
来源类型：GitHub 仓库