操作场景
通过定时任务功能，您可以让 DatabaseClaw 按计划自动执行例行运维任务，如每日巡检、定期慢查询分析等，无需手动触发。任务执行结果支持自动推送至指定 Channel（企业微信、飞书或钉钉）或通过 Webhook 推送至任意支持 HTTP 接收的系统，实现实时推送通知，并支持下载详细报告。
本文为您介绍如何创建和管理定时任务。
背景信息
定时任务是 DatabaseClaw 的自动化调度能力。您可以为 DatabaseClaw 实例配置周期性或一次性执行的运维指令，系统将按照设定的频率和时间自动发起对话并执行任务。执行结果会记录在任务历史中，方便回溯查看。同时，您可以为任务配置报送规则，将执行结果自动推送至企业微信、飞书、钉钉或通过 Webhook 推送至自定义 HTTP 端点（如企业内部告警平台、工单系统等），便于团队及时获取运维状态。
使用限制
限制项 | 限制说明 |
任务名称长度 | 1-128个字符。 |
任务类型 | 支持“每隔”（周期性执行）和“一次性”（仅执行一次）两种任务类型。周期性任务支持按分钟、小时、天为间隔重复执行。 |
任务状态 | 创建后默认为启用状态，可通过开关暂停或恢复。 |
结果投递 | Webhook：支持企业微信、飞书、钉钉群机器人，或任意自定义 HTTPS Webhook。 Channel：支持选择已接入的企业微信、飞书、钉钉等 IM Channel。 |
Webhook 支持的实例 | 2026年6月29日前创建的 DatabaseClaw 实例不支持投递 Webhook。 |
注意事项
定时任务依赖实例处于运行中状态，实例被隔离或异常期间任务将跳过执行。
任务执行内容中涉及的 Skill 需处于启用状态，否则任务将执行失败。
定时任务的执行结果不支持 L3/L4 安全等级的交互确认，建议仅配置只读类运维操作（如巡检、分析），避免配置数据变更类操作。
报送功能依赖投递目标可达。若使用 Channel 投递，需确保目标 Channel 凭证有效且状态正常；若使用 Webhook 投递，需确保目标 URL 可达且能正常响应。
使用 Webhook 投递时，若 Webhook 地址失效（如群机器人被删除），相关定时任务的投递将失败，请及时更新任务配置。
使用 Webhook 投递时，系统会自动识别 URL 对应的平台类型（如企业微信），并按目标平台的标准格式构造消息体，无需手工干预。
前提条件
已创建 DatabaseClaw 实例，且实例状态为运行中。
如需配置定时任务结果报送至 Webhook，需提前准备好接收 HTTP POST 请求的 Webhook 地址。
如需通过 Webhook 投递结果，具体配置与消息格式说明请参见 接入 Webhook。
创建定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 在右侧弹框上方单击创建任务。
6. 按照以下参数配置定时任务。
参数 | 说明 | 示例 |
任务名称 | 定时任务的名称，用于标识和区分不同任务。 建议命名方式：任务场景描述-群聊名称/机器人名称，后续方便定时任务与机器人（个人）或群聊一一对应。 | MySQL 告警订阅分析-CDB 巡检 |
任务类型 | 任务的调度类型。支持以下类型： 每隔：按固定间隔周期性执行，需设置执行间隔和单位（分钟/小时/天）。 指定时间：仅在指定时间执行一次。 Cron 表达式：配置任务的执行周期，遵循标准 5 段式 cron 语法。例如 0 9 * * * 表示每天 09:00 执行，还需选择时区。 | 每隔 |
执行内容 | 对广州地域 MySQL 实例进行巡检 | |
结果投递 | 任务执行结果的投递方式，支持选项：不投递、发布到 Channel、Webhook。 Webhook：支持企业微信、飞书、钉钉群机器人，或任意自定义 HTTPS Webhook。 填写接收推送结果的 Webhook URL。填写后系统会自动校验地址格式，格式校验通过后方可保存。系统会自动识别 URL 对应的平台类型（如企业微信），并按目标平台的标准格式构造消息体推送。获取 Webhook 的方式请参见 获取 Webhook 地址。 Channel：支持选择已接入的 IM Channel（企业微信、飞书、钉钉）。 | 结果投递：Webhook Webhook 地址： https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxx |
7. 单击确定。
创建成功后，定时任务默认开启。
获取 Webhook 地址
如果结果投递方式选择 Webhook，您需要预先在企业微信、飞书、钉钉群聊中创建群机器人，并获取其 Webhook 地址。
企业微信群机器人
1. 在企业微信中打开目标群聊，单击聊天窗口右上角的 ...图标。
2. 选择消息推送，单击添加，单击自定义消息推送，设置机器人名称、头像和简介后单击保存。
3. 在机器人详情页复制 Webhook 地址。地址格式形如
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx。飞书群机器人
4. 在飞书中打开目标群聊，单击聊天窗口右上角的设置图标。
5. 在群机器人区域单击添加机器人。
6. 在机器人列表中选择自定义机器人（Custom Bot）。
7. 设置机器人名称和描述后，单击添加。
8. 复制生成的 Webhook 地址。地址格式形如
https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx。说明：
请妥善保管获取到的 Webhook 地址，避免泄露。创建定时任务时，将该地址填入“Webhook 地址”参数即可，系统会自动识别平台类型（企业微信/飞书）并按对应格式推送消息。
钉钉群机器人
9. 在钉钉中打开目标群聊，单击聊天窗口右上角的群设置图标。
10. 单击机器人区域，单击添加机器人。
11. 在机器人列表中选择自定义。
12. 单击添加，输入机器人名称、进行安全设置，勾选同意《自定义机器人服务及免责条款》，单击完成。
完成后页面会显示生成的 Webhook 地址，单击复制即可。地址格式示例：
https://oapi.dingtalk.com/robot/send?access_token=f97ae47948cc1ef45b9624e39cc5fb231eb922179b746e748f49b14fc1468e04。注意：
钉钉自定义机器人必须配置安全设置。若选择自定义关键词，需确保推送内容包含该关键词，否则消息会被钉钉拦截导致推送失败。
说明：
请妥善保管获取到的 Webhook 地址，避免泄露。创建定时任务时，将该地址填入“Webhook 地址”参数即可，系统会自动识别平台类型，并按对应格式推送消息。
获取 Channel 投递目标 ID
投递目标 | ID 格式 | 获取方式 |
企业微信个人 | 企业微信用户 ID（UserId）。 说明： UserId 由企业管理员在创建成员时自行设定，不同企业的命名规则不同，没有统一的固定前缀。 | 1. 进入与机器人的对话窗口。 2. 输入：我的个人 UserId 是多少？ |
企业微信群聊 | 企业微信群聊 ID（ChatId）。 格式：wecom:wrcjdsYwAApJ4ELyp7qNmxqDyWjlZYZQ | 1. 进入群聊后 @机器人。 2. 输入：当前群聊 ID 是多少？以“wecom:wrxxxx”的格式返回 |
飞书个人 | 飞书用户 Open ID。 格式：ou_a073f5f53f9d176455ce51f6b892da4c | 1. 进入与机器人的对话窗口。 2. 输入：我的个人用户 ID 是多少？以“ou_xxxx”的格式返回 |
飞书群聊 | 飞书群 Chat ID。 格式：oc_b481537341c76fa12f8321a4c4e97d8e | 1. 进入群聊后 @机器人。 2. 输入：当前群聊 ID 是多少？以“oc_xxxx”的格式返回 |
钉钉个人 | 钉钉渠道的用户标识（sender_id）。 格式：012241494714780847 | 1. 进入与机器人的对话窗口。 1. 输入：我的个人 sender_id 是多少？ |
钉钉群聊 | 钉钉群聊 ID。 格式：cid17n3JJL7TStIp/csKMBjQA== | 1. 进入群聊后 @机器人。 2. 输入：当前群聊 ID 是多少？以“cidxxxx”的格式返回 |
查看任务执行结果
创建定时任务时，若配置了结果投递（发布到 Channel 或 Webhook），任务执行完成后，系统会将执行结果自动推送至已配置的投递目标。
通过 Webhook 查看
通过 Webhook 投递时，系统会将任务执行结果以 HTTP POST 请求的方式推送至配置的 Webhook URL。系统自动识别目标平台类型，按平台标准格式构造消息体：
企业微信 Webhook：系统识别到 URL 为企业微信群机器人 Webhook 地址后，自动以 Markdown 格式推送消息至对应群聊。
飞书 Webhook：系统识别到 URL 为飞书群机器人 Webhook 地址后，自动以 Markdown 格式推送消息至对应群聊。
钉钉 Webhook：系统识别到 URL 为钉钉群机器人 Webhook 地址后，自动以 Markdown 格式推送消息至对应群聊。
自定义 Webhook：消息正文占位符将被替换为 Agent 生成的 Markdown 文本内容。
推送格式预览
POST https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=****Content-Type: application/json{"msgtype": "markdown","markdown": {"content": "${summary}"}}
POST https://open.feishu.cn/open-apis/bot/v2/hook/b73956c2-1655-4fc3-87d5-f8b91a52a90dContent-Type: application/json{"msg_type": "interactive","card": {"content": "{{任务名称}}","elements": [{"tag": "markdown","content": "${summary}"}]}}
POST https://oapi.dingtalk.com/robot/send?access_token=***Content-Type: application/json{"msgtype": "markdown","markdown": {"title": "{{任务名称}}","text": "${summary}"}}
其中
${summary} 为系统自动构造的占位符，实际推送时将被替换为 Agent 生成的 Markdown 文本内容。示例：企业微信群聊
说明：
消息体由系统按目标平台规范自动构造，正文占位符将被替换为 Agent 生成的 Markdown 文本，无需手工干预。
通过 Channel 查看
通过 Channel 投递时，执行结果会推送至对应的企业微信或飞书对话中，并支持下载详细报告。
示例：飞书群聊
在控制台查看执行历史
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 单击目标任务，单击展开记录，展开任务卡片可查看执行历史记录，每条记录包含以下信息。
字段 | 说明 |
执行时间 | 任务实际执行的时间。 |
执行状态 | 成功或失败。 |
任务卡片展开后还可查看以下详细信息：
字段 | 说明 |
执行时间 | 任务的执行周期和间隔。 |
上次执行 | 上一次任务执行的具体时间。 |
执行内容 | 任务配置的自然语言指令。 |
结果投递 | 已配置的投递方式和投递目标地址。 |
启停定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 在定时任务列表中，通过开关可暂停或恢复任务。
关闭开关：暂停任务，系统不再按计划执行。
开启开关：恢复任务，系统按计划继续执行。
编辑/删除定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 单击目标任务，进行编辑和删除操作。
编辑：单击编辑，编辑定时任务名称、频率、执行时间、执行内容和报送配置，单击确定。
删除：单击删除，阅读删除注意事项，确认无误后，单击删除。
注意：
删除操作不可恢复，任务的执行历史记录将一并删除。
后续步骤
相关操作
使用对话功能
快速体验指南
接入飞书
接入企业微信
接入钉钉
常见问题
Q1：定时任务执行失败怎么办？
请检查任务执行内容中涉及的 Skill 是否已启用。您可以在执行历史中查看失败详情。
Q2：可以同时创建多个定时任务吗？
可以。每个 DatabaseClaw 实例支持创建多个定时任务，各任务独立调度互不影响。
Q3：Webhook 投递失败怎么办？
请确认以下几点：
Webhook URL 是否正确且可达。
目标服务是否能正常响应 HTTP POST 请求。
如使用企业微信群机器人 Webhook，请确认机器人未被禁用或移除。
您可以在定时任务的执行历史中查看投递状态和详细信息。
Q4：一次性任务执行后会自动删除吗？
不会自动删除。一次性任务执行完成后，任务仍保留在定时任务列表中，状态显示为已完成，您可以查看其执行历史记录。如不再需要，可手动删除。
