接入飞书

最近更新时间:2026-06-09 14:55:17

我的收藏

操作场景

DatabaseClaw 提供 Channel 接入能力,支持将 DatabaseClaw 实例与飞书机器人对接。完成接入后,您的团队成员可直接在飞书中 @ 机器人与 DatabaseClaw 实例对话,执行数据库运维操作,无需登录控制台。
本文主要介绍如何在购买 DatabaseClaw 实例后,手动配置接入飞书机器人。

前提条件

已创建 DatabaseClaw 实例,且实例处于运行中状态。
当前操作账号为该 DatabaseClaw 实例的 Owner。
您已经拥有一个飞书账号。

操作步骤

步骤一:请阅读 DatabaseClaw 实例接入 Channel 的功能说明

具体说明请参见 接入 Channel 功能简介

步骤二:获取飞书平台凭证

1. 登录 飞书开放平台,在顶部导航栏,单击开发者后台,单击创建企业自建应用,填写应用名称、描述,选择应用图标,单击创建

2. 进入应用详情页,在左侧导航栏选择凭证与基础信息,在页面中找到 App ID App Secret 两个参数,分别单击右侧

,将其保存到个人记事本或备忘录中(注意数据安全,勿泄露),后续步骤中需要使用。

3. 在左侧导航栏选择添加应用能力,选择按能力添加页签,在机器人卡片中单击添加


步骤三:在 DatabaseClaw 配置 Channel 接入

2. 在左侧导航栏,选择 DatabaseClaw > 实例管理
3. 找到目标实例,在实例卡片右上角方 ... ,选择 Channel 接入
4. 在弹出的 Channel 页面中,单击 + 接入 Channel
5. 选择需要接入的 IM 类型:飞书

接入飞书 Channel 对话框中,填写以下参数:
参数
是否必填
说明
Channel 名称
自定义名称,用于在多个 Channel 间进行辨识。
建议命名方式:飞书-使用角色-企业自建应用名称,后续方便 Channel 与企业自建应用一一对应。
示例:feishu-dba-龙虾testzm
绑定的龙虾
-
自动继承自入口实例,不可修改。
App ID
获取步骤请参见 步骤二:获取 IM 平台凭证
App Secret
获取方案请参见 步骤二:获取 IM 平台凭证。提交后通过 KMS 信封加密存储,回显时脱敏显示。示例:cli****
参数填写完成后,单击添加并应用

步骤四:配置飞书机器人并发布版本

1. 继续进入飞书开放平台,在左侧导航栏选择事件与回调,选择事件配置页签,在订阅方式右侧单击

,订阅方式选择使用长连接接收事件,单击验证,显示连接成功后,单击保存

注意:
如果这一步报错,请检查 在 DatabaseClaw 配置 Channel 接入 中的 App ID 和 App Secret 是否已正确配置。
2. 事件配置页面单击添加事件

3. 在弹出的对话框中,搜索并添加 im.chat:xx、im.message:xx,单击添加,单击确认开通权限

添加完成后,在当前页面查看已添加的事件。

4. 选择回调配置页签,在订阅方式右侧单击

,订阅方式选择使用长连接接收事件,单击验证,显示连接成功后,单击保存

5. 在左侧导航栏选择权限管理,单击开通权限,在弹出的对话框中,搜索并添加 im:chat:xx、im:message:xx,单击确认开通权限


确认开通完成后,可在页面查看已添加的权限。

6. 在左侧导航栏选择版本管理与发布,单击创建版本,在可用范围单击编辑,选择使用人员,单击确定。配置完成后单击保存


7. 在弹出的对话框中单击确认发布
若创建版本后,提示“企业管理员正在审核应用发布申请”,请根据以下情况处理:
登录账号非管理员:请在飞书内部联系您所属组织/公司的管理员进行审核。
登录账号为管理员:登录 飞书管理后台,在左侧导航栏选择工作台 > 应用审核,在应用列表对应的操作列单击审核,在弹出的页面右上方单击通过
如果您想后续免审发布机器人,可单击设置审核规则,开启默认规则即可开启全员免审(蓝色为开启状态)。


使用机器人与 DatabaseClaw 对话

完成 Channel 接入后,您的团队成员即可在飞书中与 DatabaseClaw 实例对话。
场景
使用方式
私聊
在飞书中搜索并打开与该机器人的私聊窗口,直接发送消息即可触发响应,无需 @机器人。

群聊
1. 将机器人添加至目标飞书群(群设置 > 群机器人 > 添加机器人,选择已创建的自建应用)。

2. 在群聊输入框中输入 @,从弹出列表中选择该机器人。
3. 输入问题后发送。仅 @ 机器人的消息会触发响应,群内其他普通消息不会被处理。

首次使用:完成身份绑定

私聊或群聊场景首次与机器人对话时,机器人会自动回复一条 OAuth 授权引导消息(包含授权链接),需完成腾讯云账号身份绑定(仅需操作一次)。

1. 向机器人发送任意消息,机器人将自动回复一条包含授权链接的引导消息。
2. 点击授权链接,在浏览器中完成腾讯云账号登录授权。
3. 授权成功后,浏览器页面显示一段 Base64 字符串,复制完整字符串。
4. 将复制的字符串发送给机器人,完成身份绑定。
说明:
未完成绑定的用户发送的消息不会被投递处理,不消耗资源。

后续操作

创建定时任务结果投递

1. 登录 数据库 AI 服务控制台,在左侧导航栏选择 DatabaseClaw > 实例管理
2. 单击目标实例卡片,在对话页面顶部工具栏,单击定时任务
3. 在右侧弹框上方单击创建任务,按照以下参数配置定时任务。

参数
说明
任务名称
定时任务的名称,用于标识和区分不同任务。
建议命名方式:任务场景描述-群聊名称/机器人名称,后续方便定时任务与机器人(个人)或群聊一一对应。
示例:
个人:每日健康巡检-龙虾 testzm
群聊:每日健康巡检-CDB 巡检
频率
任务执行的重复周期,执行频率支持每小时、每天、每周或每月重复。
执行时间
任务每次触发的具体时间点,格式为 HH:mm。
执行内容
任务执行的具体操作描述,即发送给 AI 的指令内容。
结果投递
任务执行结果的投递方式,选择发布到 Channel
Channel 类型
结果投递的渠道类型,选择飞书
投递目标
结果投递的具体目标,请填写个人或群聊的 ID。
获取方式:
个人:进入与机器人的对话窗口,输入:我的个人用户 ID 是多少?以“ou_xxxx”的格式返回。
群聊:进入群聊后 @机器人输入:当前群聊 ID 是多少?以“oc_xxxx”的格式返回。
4. 单击确定
创建成功后,定时任务默认开启。

查看定时任务执行结果和报告

任务执行完成后,系统会将执行结果自动推送至已配置的投递目标,并支持下载详细报告。
个人:机器人会直接输出定时任务执行结果。
群聊:打开群聊,机器人会直接输出定时任务执行结果。
示例:群聊


相关操作