操作场景
通过定时任务功能，您可以让 DatabaseClaw 按计划自动执行例行运维任务，如每日巡检、定期慢查询分析等，无需手动触发。本文介绍如何创建和管理定时任务。
背景信息
定时任务是 DatabaseClaw 的自动化调度能力。您可以为 Claw 实例配置周期性执行的运维指令，系统将按照设定的频率和时间自动发起对话并执行任务。执行结果会记录在任务历史中，方便回溯查看。
使用限制
限制项 | 限制说明 |
任务名称长度 | 1-128个字符。 |
执行频率 | 支持每小时、每天、每周和每月四种频率。 |
任务状态 | 创建后默认为启用状态，可通过开关暂停或恢复。 |
注意事项
定时任务依赖实例处于运行中状态，实例被隔离或异常期间任务将跳过执行。
任务执行内容中涉及的 Skill 需处于启用状态，否则任务将执行失败。
定时任务的执行结果不支持 L3/L4 安全等级的交互确认，建议仅配置只读类运维操作（如巡检、分析），避免配置数据变更类操作。
前提条件
已创建 DatabaseClaw 实例，且实例状态为运行中。
已为实例配置数据源，否则依赖数据库连接的任务将无法正常执行。
操作步骤
创建定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 在右侧弹框上方单击创建任务。
6. 按照以下参数配置定时任务。
参数 | 是否必填 | 说明 |
任务名称 | 是 | 1-128个字符，如“每日健康巡检”。 |
频率 | 是 | 选择执行频率：每小时、每天、每周或每月。 |
执行时间 | 是 | 设置执行的时间点。 |
执行内容 | 是 | 用自然语言描述要执行的任务内容，如“对所有 MySQL 实例执行健康巡检”。 |
7. 单击确定。
创建成功后，定时任务默认开启。
启停定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 在定时任务列表中，通过开关可暂停或恢复任务。
关闭开关：暂停任务，系统不再按计划执行。
开启开关：恢复任务，系统按计划继续执行。
查看执行历史
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 单击目标任务，单击展开记录，展开任务卡片可查看执行历史记录，每条记录包含以下信息。
字段 | 说明 |
执行时间 | 任务实际执行的时间。 |
执行状态 | 成功或失败。 |
编辑/删除定时任务
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 实例管理。
3. 单击目标实例卡片，进入对话页面。
4. 在对话页面顶部工具栏，单击定时任务。
5. 单击目标任务，进行编辑和删除操作。
编辑：单击编辑，编辑定时任务名称、频率、执行时间、执行内容，单击确定。
删除：单击删除，阅读删除注意事项，确认无误后，单击删除。
注意：
删除操作不可恢复，任务的执行历史记录将一并删除。
后续步骤
相关操作
使用对话功能
常见问题
定时任务执行失败怎么办？
请检查任务执行内容中涉及的 Skill 是否已启用，以及相关数据源是否连通正常。您可以在执行历史中查看失败详情。
可以同时创建多个定时任务吗？
可以。每个 Claw 实例支持创建多个定时任务，各任务独立调度互不影响。
