Clawdbot 接入飞书机器人
本文档介绍如何将 Clawdbot 与飞书开放平台集成,实现消息收发、群聊互动等功能。流程主要包括安装插件、配置飞书应用权限以及本地参数设置。
安装插件
首先需要在项目中安装飞书适配器插件:
clawdbot plugins install @m1heng-clawd/feishu
安装完成后,建议重启服务以确保插件生效:
clawdbot daemon restart
在飞书开放平台创建自建应用
登录飞书开放平台,创建自建应用并配置相应的权限范围。以下是必需的配置项:
权限范围
| 权限 Scope | 说明 | 用途 |
|---|---|---|
contact:user.base:readonly | 用户信息 | 获取用户基本信息 |
im:message | 消息 | 发送和接收消息 |
im:message.p2p_msg:readonly | 私聊 | 读取发给机器人的私聊消息 |
im:message.group_at_msg:readonly | 群聊 | 接收群内@机器人的消息 |
im:message:send_as_bot | 发送 | 以机器人身份发送消息 |
im:resource | 媒体 | 上传和下载图片/文件 |
事件订阅
确保订阅以下事件以支持核心功能:
| 事件名称 | 说明 |
|---|---|
im.message.receive_v1 | 接收消息(必需) |
im.message.message_read_v1 | 消息已读回执 |
im.chat.member.bot.added_v1 | 机器人进群 |
im.chat.member.bot.deleted_v1 | 机器人被移出群 |
注意:完成配置后需提交审核,审核通过后才能正式使用相关接口。



