配置飞书

按照以下步骤完成飞书机器人的创建与配置

第一步:创建飞书应用

1. 打开飞书开放平台

访问 https://open.feishu.cn/app,使用飞书账号登录。

2. 创建应用

  1. 点击 创建企业自建应用
  2. 填写应用名称和描述
  3. 选择应用图标
示例图

第二步:获取应用凭证

在应用的 凭证与基础信息 页面,复制:

?? 重要:请妥善保管 App Secret,不要分享给他人。

示例图

第三步:输入应用凭证

在绑定页面输入 App ID 和 App Secret

示例图

第四步:配置应用权限

在 权限管理 页面,点击 批量导入 按鈕,粘贴以下 JSON 配置一键导入所需权限:

{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:contact.base:readonly", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } }

?? 注意:im:message.group_msg 权限(获取群组中所有消息,属于敏感权限)允许机器人接收群组中所有消息(不仅仅是 @机器人的)。如果您需要配置 requireMention: false 让机器人无需 @ 也能响应,则必须添加此权限。

示例图

第五步:启用机器人能力

在 应用能力 > 机器人 页面:

  1. 开启机器人能力
  2. 配置机器人名称
示例图

第六步:配置事件订阅

???? 重要提醒:在配置事件订阅前,请务必确保已完成以下步骤:

  1. 运行 openclaw-cn channels add 添加了 Feishu 渠道
  2. 网关处于启动状态(可通过 openclaw-cn gateway status 检查状态)

在 事件订阅 页面:

  1. 选择 使用长连接接收事件(WebSocket 模式)
  2. 添加事件:im.message.receive_v1(接收消息)

???? 注意:如果网关未启动或渠道未添加,长连接设置将保存失败。

示例图

第七步:发布应用

  1. 版本管理与发布 页面创建版本
  2. 提交审核并发布
  3. 等待管理员审批(企业自建应用通常自动通过)

第八步:配对

1. 发送测试消息

在飞书中找到您创建的机器人,发送一条消息。


2. 配对授权

默认情况下,机器人会回复一个 配对码。将整行 配对命令 复制出来:

示例图

3. 完成配对

在配对界面输入复制出来的 配对命令,然后点击【完成配对】。

示例图