操作场景
通过定时任务功能，您可以让 DatabaseClaw 按计划自动执行例行运维任务，如每日巡检、定期慢查询分析等，无需手动触发。任务执行结果支持自动发布到指定 Channel（企业微信或飞书），实现实时推送通知，并支持下载详细报告。
本文为您介绍如何创建和管理定时任务。
背景信息
定时任务是 DatabaseClaw 的自动化调度能力。您可以为 Claw 实例配置周期性执行的运维指令，系统将按照设定的频率和时间自动发起对话并执行任务。执行结果会记录在任务历史中，方便回溯查看。同时，您可以为任务配置报送规则，将执行结果自动推送至企业微信或飞书群聊，便于团队及时获取运维状态。
使用限制
限制项 | 限制说明 |
任务名称长度 | 1-128个字符。 |
执行频率 | 支持每小时、每天、每周和每月四种频率。 |
任务状态 | 创建后默认为启用状态，可通过开关暂停或恢复。 |
结果投递 Channel | 目前仅支持企业微信和飞书，投送目标均支持个人和群聊。 |
注意事项
定时任务依赖实例处于运行中状态，实例被隔离或异常期间任务将跳过执行。
任务执行内容中涉及的 Skill 需处于启用状态，否则任务将执行失败。
定时任务的执行结果不支持 L3/L4 安全等级的交互确认，建议仅配置只读类运维操作（如巡检、分析），避免配置数据变更类操作。
报送功能依赖 Channel 处于正常状态。若目标 Channel 凭证过期或状态异常，任务结果将无法推送。
前提条件
已创建 DatabaseClaw 实例，且实例状态为运行中。
创建定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 在右侧弹框上方单击创建任务。
6. 按照以下参数配置定时任务。
参数 | 说明 | 示例 |
任务名称 | 定时任务的名称，用于标识和区分不同任务。 建议命名方式：任务场景描述-群聊名称/机器人名称，后续方便定时任务与机器人（个人）或群聊一一对应。 示例： 个人：每日健康巡检-龙虾 testzm 群聊：每日健康巡检-CDB 巡检 | 每日健康巡检-CDB 巡检 |
频率 | 任务执行的重复周期，执行频率支持每小时、每天、每周或每月重复。 | 每天重复 |
执行时间 | 任务每次触发的具体时间点，格式为 HH:mm。 | 09:00 |
执行内容 | 任务执行的具体操作描述，即发送给 AI 的指令内容。 | 对所有 MySQL 实例执行健康巡检 |
结果投递 | 任务执行结果的投递方式，支持选项：不投递、发布到 Channel。 | 发布到 Channel |
Channel 类型 | 结果投递的渠道类型，支持选项：企业微信、飞书。 | 飞书 |
投递目标 | 结果投递的具体目标，请填写个人或群聊的 ID。 | oc_b481537341c76fa12f8321a4c4e97d8c |
7. 单击确定。
创建成功后，定时任务默认开启。
获取投递目标 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”的格式返回 |
在 Channel 中查看任务执行结果
创建定时任务时，若将结果投递方式设置为发布到 Channel，任务执行完成后，系统会将执行结果自动推送至已配置的投递目标，并支持下载详细报告。
示例：飞书群聊
在控制台查看执行历史
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 单击目标任务，单击展开记录，展开任务卡片可查看执行历史记录，每条记录包含以下信息。
字段 | 说明 |
执行时间 | 任务实际执行的时间。 |
执行状态 | 成功或失败。 |
启停定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 在定时任务列表中，通过开关可暂停或恢复任务。
关闭开关：暂停任务，系统不再按计划执行。
开启开关：恢复任务，系统按计划继续执行。
编辑/删除定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 单击目标任务，进行编辑和删除操作。
编辑：单击编辑，编辑定时任务名称、频率、执行时间、执行内容，单击确定。
删除：单击删除，阅读删除注意事项，确认无误后，单击删除。
注意：
删除操作不可恢复，任务的执行历史记录将一并删除。
后续步骤
相关操作
使用对话功能
接入飞书
接入企业微信
常见问题
定时任务执行失败怎么办？
请检查任务执行内容中涉及的 Skill 是否已启用。您可以在执行历史中查看失败详情。
可以同时创建多个定时任务吗？
可以。每个 Claw 实例支持创建多个定时任务，各任务独立调度互不影响。
