操作场景
DatabaseClaw 提供 Channel 接入能力,支持将 DatabaseClaw 实例与飞书机器人对接。完成接入后,您的团队成员可直接在飞书中 @ 机器人与 DatabaseClaw 实例对话,执行数据库运维操作,无需登录控制台。
本文主要介绍如何在购买 DatabaseClaw 实例后,手动配置接入飞书机器人。
前提条件
已创建 DatabaseClaw 实例,且实例处于运行中状态。
当前操作账号为该 DatabaseClaw 实例的 Owner。
您已经拥有一个飞书账号。
操作步骤
步骤一:请阅读 DatabaseClaw 实例接入 Channel 的功能说明
步骤二:获取飞书平台凭证
1. 登录 飞书开放平台,在顶部导航栏,单击开发者后台,单击创建企业自建应用,填写应用名称、描述,选择应用图标,单击创建。

2. 进入应用详情页,在左侧导航栏选择凭证与基础信息,在页面中找到 App ID 和 App Secret 两个参数,分别单击右侧
,将其保存到个人记事本或备忘录中(注意数据安全,勿泄露),后续步骤中需要使用。


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

步骤三:在 DatabaseClaw 配置 Channel 接入
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏,选择 DatabaseClaw > 实例管理。
3. 找到目标实例,在实例卡片右上角方 ... ,选择 Channel 接入。
4. 在弹出的 Channel 页面中,单击 + 接入 Channel。
5. 选择需要接入的 IM 类型:飞书。

在接入飞书 Channel 对话框中,填写以下参数:
参数 | 是否必填 | 说明 |
Channel 名称 | 是 | 自定义名称,用于在多个 Channel 间进行辨识。 建议命名方式:飞书-使用角色-企业自建应用名称,后续方便 Channel 与企业自建应用一一对应。 示例: feishu-dba-龙虾testzm。 |
绑定的龙虾 | - | 自动继承自入口实例,不可修改。 |
App ID | 是 | |
App Secret | 是 |
参数填写完成后,单击添加并应用。
步骤四:配置飞书机器人并发布版本
1. 继续进入飞书开放平台,在左侧导航栏选择事件与回调,选择事件配置页签,在订阅方式右侧单击 
,订阅方式选择使用长连接接收事件,单击验证,显示连接成功后,单击保存。


注意:
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. 单击确定。
创建成功后,定时任务默认开启。
查看定时任务执行结果和报告
任务执行完成后,系统会将执行结果自动推送至已配置的投递目标,并支持下载详细报告。
个人:机器人会直接输出定时任务执行结果。
群聊:打开群聊,机器人会直接输出定时任务执行结果。
示例:群聊

相关操作
管理定时任务

