连接飞书 Bot

通过飞书消息渠道，您可以直接在飞书中与 StoreClaw 对话，也可以将定时任务结果推送到指定群聊或会话。本文介绍如何在飞书开放平台创建自建应用，启用机器人能力，并完成与 StoreClaw 的连接。

前置条件

开始前，请确认以下三项均已满足：

1. 飞书账号： 已注册并可正常登录飞书。
2. 所属企业（Org）： 当前账号已加入一个飞书企业或团队。飞书自建应用（Custom App）必须挂在企业下，个人账号无法单独创建应用。
3. 开发者权限： 当前账号在该企业内具备 开发者 或 企业管理员 权限。普通成员无权在开放平台（Open Platform）创建应用；如权限不足，请联系企业管理员开通。

第一步：登录飞书开放平台

访问 Feishu Open Platform，使用飞书账号完成注册或登录后，点击右上角 开发者后台 进入控制台。

第二步：创建自建应用（Custom App）

1. 点击 创建企业自建应用。
2. 填写应用名称和描述，点击确认，完成创建。

第三步：启用机器人能力

1. 进入应用详情页。
2. 点击左侧菜单 添加应用能力。
3. 找到 机器人 卡片并点击 添加。

第四步：配置权限与范围（Permissions & Scopes）

1. 点击左侧菜单 权限管理。
2. 点击开通权限，搜索并添加以下权限。
3. 点击 确认开通权限 保存配置。

必须添加的权限

以下权限用于支持机器人基础消息能力：

• im:message：消息基础权限
• im:message:send_as_bot：以 Bot 身份发送消息
• im:message.group_msg：发送群消息
• im:chat：访问会话
• im:resource：发送图片、文件等富媒体内容
• contact:user.base:readonly：读取用户基础信息，支持 @ 用户

按需添加的权限

如果您希望机器人接收用户消息，建议继续添加以下权限：

• im:message:readonly：读取消息内容
• im:message.p2p_msg:readonly：读取私信
• im:message.group_at_msg:readonly：读取群内 @Bot 的消息
• im:chat.access_event.bot_p2p_chat:read：接收 Bot 私聊事件推送

第五步：配置事件与回调

1. 打开应用左侧菜单中的 事件与回调 相关页面。
2. 点击订阅方式后的铅笔图标
3. 事件接收方式选择 使用长连接接收事件。

3. 回调事件中添加以下项目：
   • im.message.reaction.created_v1
   • im.message.reaction.deleted_v1
   • im.message.receive_v1

说明： 长连接方式更适合当前这类 Bot 场景，配置简单，也不需要额外准备公网回调地址。如果您在 Feishu 开发者界面修改了事件回调的项目范围，需要回到 StoreClaw 手动重新连接下飞书来获取新的事件注册。

第六步：发布审批（如需）

如果您的企业启用了应用审批流程，需要先创建发布版本并完成审批：

1. 点击左侧 版本管理与发布。
2. 点击 创建版本。
3. 填写版本说明并提交。
4. 等待企业管理员审批通过。

审批成功后，您通常就可以在飞书助手中找到该应用，并发起会话。

第七步：获取凭证

1. 点击左侧菜单 凭证与基础信息。
2. 在 应用凭证 区域复制以下两项：
   • App ID
   • App Secret

这两项信息需要填写到 StoreClaw 的飞书配置页面中。

在 StoreClaw 中完成配置

1. 回到 StoreClaw，打开 消息渠道 页面。
2. 找到 Feishu Bot 卡片并点击 配置。
3. 填入刚才复制的 App ID 和 App Secret。
4. 保存后，若卡片显示已连接状态，则说明配置成功。

接下来，您就可以在飞书中与 StoreClaw 的 AI 发起对话。

连接后能做什么

完成连接后，您可以：

• 在飞书私聊或群聊中与 StoreClaw Bot 对话
• 在频道中 @ Bot 发送任务或问题
• 将定时任务执行结果推送到飞书群或指定会话

常见问题 (FAQ)