帮你快速理解、总结文档立即下载

接入 Channel 功能简介

最近更新时间:2026-09-02 17:15:00
我的收藏

功能简介

DatabaseClaw 提供 Channel 接入能力,支持将 DatabaseClaw 实例与飞书、企业微信或钉钉机器人对接。完成接入后,您的团队成员可直接在 IM 中 @ 机器人与 DatabaseClaw 实例对话,执行数据库运维操作,无需登录控制台。
除 IM 机器人双向对话外,DatabaseClaw 还支持将定时任务的执行结果通过 Webhook 推送至您指定的地址(企业微信、飞书、钉钉群机器人或任意支持 HTTP 回调的自有系统)。Webhook 属于定时任务结果投递能力,不是独立的 Channel 接入类型,配置方法请参见 接入 Webhook
DatabaseClaw 实例将自动完成身份识别与对话隔离,并以提问者的 CAM 权限执行请求,交互体验与控制台保持一致。

支持的接入类型

Channel 是 DatabaseClaw 对 IM 消息通道的统一抽象。每个 Channel 对应一个 IM 平台(如飞书、企业微信、钉钉)的机器人应用,并绑定至一个 DatabaseClaw 实例。
当前支持的接入类型如下表所示:
接入类型
接入方式
所需凭证
飞书
手动配置
App ID + App Secret
企业微信
手动配置
Bot ID + Bot Secret
钉钉
手动配置
Client ID + Client Secret

实现机制

Channel 遵循以下核心机制:
1:1 绑定:每个 Channel 固定路由至一个 DatabaseClaw 实例。同一 DatabaseClaw 实例同类型的 IM Channel 仅支持接入一个。
权限继承: DatabaseClaw 实例以绑定者的 CAM 子账号身份调用云 API,权限管控逻辑与控制台一致。

使用限制

限制项
说明
接入类型
当前支持飞书、企业微信、钉钉三种 IM 类型。
绑定关系
每个 Channel 仅可绑定一个 DatabaseClaw 实例,不支持改绑。如需变更绑定关系,请删除后重新创建。
实例状态
实例处于运行中状态。实例处于重启、已停止或已隔离状态时,Channel 不可用。
身份认证
同一 IM 用户同一时间仅可绑定一个 DatabaseClaw 实例。对另一个 DatabaseClaw 实例重新绑定 IM 后,原实例的绑定关系将被覆盖,原实例最迟在 2 小时内(本地缓存临时密钥过期后)停止响应该用户的消息。
凭证安全
凭证通过 KMS 信封加密存储,控制台回显时仅展示脱敏字符。

注意事项

接入 IM 类型 Channel(飞书、企业微信、钉钉)前,您需先在对应平台完成应用创建并获取相应凭证。未获取凭证将无法完成配置。
提交配置后,系统需将凭证同步至 Gateway,同步期间(约 30 秒)IM 消息暂时无法送达。
删除 Channel 将同步清除全部 IM 用户的身份绑定关系。

前提条件

已创建 DatabaseClaw 实例,且实例处于运行中状态。
当前操作账号为该 DatabaseClaw 实例的 Owner。
接入 IM 类型 Channel 时,您已经拥有一个对应平台的账号。

操作指引

如需接入或管理 Channel,请参见以下文档:
操作
说明
在飞书开放平台创建自建应用,获取 App ID 和 App Secret,并将飞书机器人接入 DatabaseClaw 实例。
在企业微信管理后台创建应用,获取 Bot ID 和 Bot Secret,并将企业微信机器人接入 DatabaseClaw 实例。
在钉钉开放平台创建企业内部应用,获取 Client ID 和 Client Secret,并将钉钉机器人接入 DatabaseClaw 实例。
了解如何通过 Webhook 将定时任务执行结果投递至企业微信、飞书、钉钉群机器人或自有系统。
查看 Channel 状态、更新凭证或删除已接入的 Channel。