需在飞书开放平台创建企业自建应用、启用机器人能力、批量导入权限json、获取app id/secret、在workbuddy中配置凭证并复制webhook地址、在飞书配置事件回调订阅“接收消息”和“卡片回传交互”、最后发布应用完成上线。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 WorkBuddy AI 并希望其通过飞书接收与响应消息，则需完成飞书开放平台侧的应用创建、权限配置及 Webhook 回调绑定。以下是实现飞书消息双向通信的具体操作步骤：
一、在飞书开放平台创建企业自建应用
该步骤用于生成 WorkBuddy 所需的唯一身份凭证（App ID 与 App Secret），是后续所有集成的基础。
1、访问飞书开放平台官网：https://open.feishu.cn/，使用企业管理员账号登录。
2、点击左上角「开发者后台」，进入后选择「创建企业自建应用」。
3、在弹出窗口中填写应用名称（如：WorkBuddy 飞书助手）与应用描述，图标可选填，点击「创建」。
二、为应用添加机器人能力
启用机器人能力后，WorkBuddy 才能以 Bot 身份在飞书群聊或私聊中收发消息。
1、应用创建成功后，自动跳转至应用详情页。
2、在能力列表中找到「机器人」卡片，点击右侧「添加」按钮。
三、批量导入必需权限
手动逐项开启权限易遗漏且耗时，官方推荐方式是通过 JSON 批量导入，确保 WorkBuddy 具备完整交互能力。
1、在应用详情页左侧菜单栏，点击「权限管理」→「批量导入 / 导出权限」。
2、切换至「导入」页签，清空输入框全部内容。
3、将以下 JSON 内容完整复制并粘贴进输入框：{"scopes":{"tenant":["contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message.pins:read","im:message.pins:write_only","im:message.reactions:read","im:message.reactions:write_only","im:message:readonly","im:message:recall","im:message:send_as_bot"]}}。
4、点击「下一步」，确认新增权限。
四、获取并保存应用凭证
App ID 和 App Secret 是 WorkBuddy 与飞书建立身份认证的关键密钥，必须准确无误填入本地设置中。
1、返回应用详情页，左侧菜单选择「凭证与基础信息」。
2、在页面中定位「App ID」和「App Secret」两项，务必完整复制并离线保存，切勿截图上传或泄露给他人。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
五、在 WorkBuddy 中配置飞书集成
此步骤将飞书应用凭证注入 WorkBuddy 客户端，使其获得合法调用飞书 API 的权限。
1、启动 WorkBuddy，点击右上角用户头像，选择「Claw Settings」。
2、在设置面板左侧导航栏中，选择「飞书集成」。
3、将上一步复制的 App ID 与 App Secret 分别粘贴至对应字段。
4、点击「注册」按钮，系统将生成一个唯一的 Webhook 地址，请立即复制该地址，后续配置回调时必需使用。
六、配置飞书事件回调与订阅
仅配置凭证无法触发消息响应，必须将 Webhook 地址注册为飞书事件接收端，才能让飞书把用户消息实时推送至 WorkBuddy。
1、回到飞书开放平台，进入该应用的详情页。
2、左侧菜单选择「事件与回调」→「事件配置」→「订阅方式」。
3、选择「将事件发送至开发者服务器」，在请求地址栏中粘贴上一步复制的 Webhook 地址。
4、点击「保存」，等待状态变为「已启用」。
5、在「事件类型」中勾选「接收消息」，并添加「卡片回传交互」事件。
七、发布应用并启用机器人
未发布的应用在飞书中不可见，也无法被成员添加或调用，发布是最后且必需的上线动作。
1、在应用详情页顶部点击「创建版本」。
2、填写版本号（例如：1.0.0）与版本描述（例如：首发集成 WorkBuddy AI），点击「确定」。
3、新版本创建后，点击右侧「发布」按钮。
4、若当前账号为企业管理员，通常会自动审批通过；否则需联系管理员完成审批。
