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

接入 Webhook

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

操作场景

DatabaseClaw 的 Webhook 能力用于定时任务结果投递:定时任务执行完成后,系统将执行结果以 HTTP POST 请求方式推送至您指定的 Webhook 地址。Webhook 地址可以指向企业微信、飞书、钉钉的群机器人,也可以指向任意支持接收 HTTP 回调的自有系统(如告警平台、工单系统、值班系统等)。
说明:
Webhook 不是独立的 Channel 接入类型,而是在创建定时任务时配置的“结果投递”方式之一。Channel 仅支持接入飞书、企业微信、钉钉三种 IM 机器人,用于双向对话;Webhook 仅用于定时任务执行结果的单向推送,无法用于 IM 对话。

前提条件

已创建 DatabaseClaw 实例,且实例处于运行中状态。
当前操作账号为该 DatabaseClaw 实例的 Owner。
已准备一个可公网访问、支持接收 HTTP POST 请求的 Webhook 地址。

配置方式

Webhook 结果投递在创建或编辑定时任务时配置,操作入口与完整步骤请参见 管理定时任务。核心配置如下:
1. 在定时任务配置的“结果投递”中,选择 Webhook
2. 填写接收执行结果的 Webhook 地址。
3. 保存时,系统自动校验地址格式并发送联通性探测请求,校验通过后方可保存成功。

消息体格式

系统会根据 Webhook 地址自动识别目标平台类型,并按该平台的标准格式构造消息体:
企业微信:识别到 qyapi.weixin.qq.com 域名后,按企业微信群机器人格式推送。
飞书:识别到 open.feishu.cn 域名后,按飞书群机器人格式推送。
钉钉:识别到 oapi.dingtalk.com 域名后,按钉钉群机器人格式推送。
自定义:未识别到已知平台时,按通用 JSON 格式推送。
各平台默认消息体格式预览请参见 管理定时任务

自定义消息体模板

如需自定义推送内容,可在配置时提供消息体模板。模板支持 ${summary} 占位符,实际推送时将被替换为 Agent 生成的执行结果内容;未配置模板时,系统使用默认格式推送。

联通性校验

保存配置时,系统会对 Webhook 地址执行以下校验:
地址格式校验:地址必须以 http://https:// 开头。
安全防护:系统使用安全网络组件对目标地址执行 SSRF 防护,拦截内网、回环及元数据地址,避免被恶意地址利用。
联通性探测:系统向目标地址发送一次探测请求。对已识别的平台(企业微信、飞书等)会进一步校验响应中的业务返回码;对自定义地址仅校验网络可达性。
模板校验:若配置了自定义消息体模板,探测时使用替换占位符后的真实请求体。

相关操作