Molili 飞书机器人教程

1

创建飞书自建应用

飞书开放平台创建自建应用,点击右上角"开发者后台"
"创建企业自建应用"
填写合适的信息
凭证与基础信息中获取App ID和App Secret,填写到Molili客户端中
2

添加机器人能力

添加应用能力-机器人
3

权限管理配置

"权限管理"开启以下权限

必需权限 消息与通信

权限 范围 说明
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 表情 查看消息表情回复
4

事件与回调配置

"事件于回调"-"事件配置"-"订阅方式"-"使用长连接接受事件"-"保存"
保存成功后添加事件订阅(重要!!!)

必需事件订阅

事件 说明
im.message.receive_v1 接收消息(必需)
im.message.message_read_v1 消息已读回执
im.chat.member.bot.added_v1 机器人进群
im.chat.member.bot.deleted_v1 机器人被移出群
5

工具权限配置

只读权限 (最低要求)

权限 工具 说明
docx:document:readonly feishu_doc 读取文档
drive:drive:readonly feishu_drive 列出文件夹、获取文件信息
wiki:wiki:readonly feishu_wiki 列出空间、列出节点、获取节点详情、搜索
bitable:app:readonly feishu_bitable 读取多维表格记录和字段

读写权限 (可选,用于创建/编辑/删除操作)

权限 工具 说明
docx:document feishu_doc 创建/编辑文档
docx:document.block:convert feishu_doc Markdown 转 blocks(write/append 必需)
drive:drive feishu_doc, feishu_drive 上传图片到文档、创建文件夹、移动/删除文件
wiki:wiki feishu_wiki 创建/移动/重命名知识库节点
bitable:app feishu_bitable 创建/更新多维表格记录
6

发布与使用

版本管理与发布-创建版本,发布完成后,在飞书客户端搜索对应机器人开始对话