前置准备
接入飞书全流程
第一步:创建飞书应用
- 登录飞书开放平台→ 创建企业自建应用(如 “OpenClaw 助手”)
- 在应用管理页添加机器人 能力
第二步:获取关键凭证
- 进入「凭据与基础信息」→ 复制 App ID和 App Secret
(妥善保存,后续配置需使用)
第三步:配置 OpenClaw
- 模型配置
- 登录腾讯云 Lighthouse 控制台 → 应用管理 → 配置模型 API Key
- (验证技巧:通过 OpenClaw TUI 工具测试交互)
- 通道配置
- 选择「飞书」通道 → 填入 App ID 和 App Secret → 点击「应用」
- 状态显示「使用中」即成功
第四步:飞书机器人配置
- 事件配置
- 飞书后台 →「事件与回调」→ 选择 长连接接收事件→ 保存
- (若报错,重启 Lighthouse 网关服务)
- 添加事件权限
添加「接收消息」等核心权限 → 导入以下 JSON 权限代码:
{ “scopes”: { “tenant”: [ “im:message”, “im:message.p2p_msg:readonly”, … ] } }
- 回调配置
选择「使用长连接接收回调」→ 保存
第五步:发布与测试
- 创建应用版本(如0.0)→ 提交审核
- 交互测试:
私聊:飞书搜索机器人名称 → 发送消息
群聊:群设置 → 添加机器人 → 搜索应用名称添加
(首次需配对:复制命令行至 Lighthouse 终端执行)
⚡ 支持消息类型
| 功能 | 支持状态 |
| 文本收发 | ✅ |
| 图片 / 文件 / 音视频 | ✅ |
| Markdown 格式回复 | ✅ |
| 主动推送消息 | ✅ |
| 操作飞书文档 / 云盘 | ✅ |
提示:消息处理能力依赖模型性能,建议定期更新 OpenClaw 版本。
为什么选择腾讯云 Lighthouse?
- 秒级部署:预装 OpenClaw 的镜像,开箱即用
- 无缝扩展:支持同时接入 QQ / 飞书 / 微信等多通道
