操作场景
DatabaseClaw 的 Webhook 能力用于定时任务结果投递:定时任务执行完成后,系统将执行结果以 HTTP POST 请求方式推送至您指定的 Webhook 地址。Webhook 地址可以指向企业微信、飞书、钉钉的群机器人,也可以指向任意支持接收 HTTP 回调的自有系统(如告警平台、工单系统、值班系统等)。
说明:
Webhook 不是独立的 Channel 接入类型,而是在创建定时任务时配置的“结果投递”方式之一。Channel 仅支持接入飞书、企业微信、钉钉三种 IM 机器人,用于双向对话;Webhook 仅用于定时任务执行结果的单向推送,无法用于 IM 对话。
前提条件
已创建 DatabaseClaw 实例,且实例处于运行中状态。
当前操作账号为该 DatabaseClaw 实例的 Owner。
已准备一个可公网访问、支持接收 HTTP POST 请求的 Webhook 地址。
配置方式
1. 在定时任务配置的“结果投递”中,选择 Webhook。
2. 填写接收执行结果的 Webhook 地址。
3. 保存时,系统自动校验地址格式并发送联通性探测请求,校验通过后方可保存成功。
消息体格式
系统会根据 Webhook 地址自动识别目标平台类型,并按该平台的标准格式构造消息体:
企业微信:识别到
qyapi.weixin.qq.com 域名后,按企业微信群机器人格式推送。飞书:识别到
open.feishu.cn 域名后,按飞书群机器人格式推送。钉钉:识别到
oapi.dingtalk.com 域名后,按钉钉群机器人格式推送。自定义:未识别到已知平台时,按通用 JSON 格式推送。
自定义消息体模板
如需自定义推送内容,可在配置时提供消息体模板。模板支持
${summary} 占位符,实际推送时将被替换为 Agent 生成的执行结果内容;未配置模板时,系统使用默认格式推送。联通性校验
保存配置时,系统会对 Webhook 地址执行以下校验:
地址格式校验:地址必须以
http:// 或 https:// 开头。安全防护:系统使用安全网络组件对目标地址执行 SSRF 防护,拦截内网、回环及元数据地址,避免被恶意地址利用。
联通性探测:系统向目标地址发送一次探测请求。对已识别的平台(企业微信、飞书等)会进一步校验响应中的业务返回码;对自定义地址仅校验网络可达性。
模板校验:若配置了自定义消息体模板,探测时使用替换占位符后的真实请求体。
相关操作
管理定时任务