在 落地企业办公场景中,飞书凭借高效协作能力,成为众多团队的首选平台。OpenClaw(原 Clawdbot)支持一键接入飞书机器人,实现 智能对话、图片识别、文件处理、文档读写、知识库联动等完整能力。
本文将详细介绍:
如何在腾讯云轻量应用服务器 Lighthouse 上,将已部署的 OpenClaw 接入飞书自建应用机器人。
在正式开始配置 OpenClaw 接入飞书机器人前,请确保以下条件已准备完成:
- 您已拥有正常使用的飞书账号。
- 已在腾讯云轻量应用服务器 Lighthouse 中完成 OpenClaw 部署:
- 新购服务器:可前往腾讯云 Lighthouse 购买页,或 OpenClaw 专属优惠活动页面选购,详细流程参考《云上 OpenClaw(原 Clawdbot)一键秒级部署指南》。
- 版本更新:若您的 OpenClaw 应用模板创建时间早于 2026 年 2 月 11 日,请先更新版本,参考《如何更新服务器 OpenClaw 应用版本》。
- OpenClaw 接入飞书推荐使用国内服务器 + 国内模型服务,保证响应速度与稳定性。
- 使用飞书账号登录飞书开放平台。
- 点击创建企业自建应用。
- 填写应用名称(如 OpenClaw 助手)、应用描述、上传图标,点击创建。
- 进入应用管理页面。
- 在飞书应用管理页面左侧导航,点击添加应用能力。
- 选择机器人 → 点击添加。
- 添加完成后暂不发布,等待全部配置完成后统一发布。
- 左侧导航进入凭据与基础信息。
- 复制以下两个关键参数并妥善保存:
- App ID
- App Secret
- 后续将用于 OpenClaw 通道对接。
- 登录腾讯云控制台。
- 进入已部署 OpenClaw 的 Lighthouse 实例。
- 打开应用管理页面。
确保已配置好模型 API Key,详细步骤参考《OpenClaw 模型 API Key 配置指南》。
- 在通道配置中选择飞书。
- 填入飞书应用的:
- App ID
- App Secret
- 点击添加并应用 → 确认。
- 等待提示保存成功,状态显示使用中即完成。
OpenClaw 支持多通道同时运行:、企业微信、飞书可一起接入。
- 进入飞书开放平台 → 事件与回调。
- 选择长连接接收事件 → 点击保存。
⚠️ 若提示:
应用未建立长连接
解决方法:
- 检查 AppID、AppSecret 是否正确填写
- 进入 Lighthouse 应用管理 → 重启 OpenClaw 网关
- 重新保存事件配置
点击
添加事件,添加以下必备能力:
- 接收消息
(可选)群聊场景建议添加:
- 消息已读
- 机器人进群
- 机器人被移出群
- 进入事件与回调 → 回调配置。
- 订阅方式选择:使用长连接接收回调。
- 点击保存,无需填写地址。
- 进入权限管理。
- 点击批量导入权限。
- 替换为以下 JSON 配置,点击下一步并确认开通:
json
{
“scopes”: {
"tenant": [
"im:message",
"im:message.p2p_msg:readonly",
"im:message.group_at_msg:readonly",
"im:message:send_as_bot",
"im:resource",
"contact:user.base:readonly",
"im:message.group_msg",
"im:message:readonly",
"im:message:update",
"im:message:recall",
"im:message.reactions:read",
"docx:document:readonly",
"drive:drive:readonly",
"wiki:wiki:readonly",
"bitable:app:readonly",
"task:task:read",
"contact:contact.base:readonly",
"docx:document",
"docx:document.block:convert",
"drive:drive",
"wiki:wiki",
"bitable:app",
"task:task:write"
],
"user": []
} }
导入完成后,可在权限列表中查看已开通权限。
- 进入版本管理与发布。
- 点击右上角创建版本。
- 填写版本号(如 1.0.0)和更新说明。
- 保存并提交发布。
- 等待飞书管理员审核通过。
发布成功后,机器人即可正常使用。
- 打开飞书客户端。
- 搜索机器人名称。
- 进入聊天窗口,直接对话。
如出现
配对提示:
- 复制机器人返回的命令
- 使用 OrcaTerm 免密登录 Lighthouse 服务器
- 粘贴命令并执行
- 提示配对成功即可正常使用
- 进入群组 → 设置 → 群机器人。
- 点击添加机器人。
- 搜索并选择已创建的 OpenClaw 机器人。
- 添加完成即可在群内 @ 机器人对话。
注意:仅支持添加到
同一企业内部群。
OpenClaw 接入飞书后,支持丰富的消息交互能力(实际能力取决于模型):
功能 支持状态 接收文本 ✅ 接收图片 ✅ 接收文件 ✅ 接收音频、视频 ✅ 回复文本 ✅ 回复图片 ✅ 回复文件 ✅ 回复音频 ✅ Markdown 格式回复 ✅ 主动发送消息 ✅
- 文档工具:读取、创建、写入飞书文档(Markdown 支持)
- 知识库工具:浏览 Wiki、搜索 / 创建 / 移动 / 重命名节点
- 云空间工具:展示文件夹、获取文件信息、移动 / 删除文件
飞书仅为消息通道,图片理解、文件解析等能力需配置对应多模态模型。
-
提示 “应用未建立长连接”
- 检查 AppID、AppSecret 是否正确
- 重启 OpenClaw 网关服务
-
机器人不回复
- 确认应用已发布
- 确认事件与权限已配置
- 检查模型 API Key 是否有效
-
无法加入群聊
- 仅支持同一企业内部群
- 检查是否已开通群聊相关事件
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/278277.html