定时任务

概述#

定时任务页面集中展示 OpenClaw 网关上所有的计划任务。定时任务在 OpenClaw 配置中定义，按设定的周期执行——从定期数据同步到自动化报告生成。

ClawButler 通过运行历史追踪、成功率计算和连续失败告警（FR-208）来监控任务执行的可靠性。当某个任务连续失败时，你会在它演变为无声故障之前收到通知。结合仪表盘的运营脉搏条，定时任务监控确保你的自动化流程保持健康运行。

前置条件#

OpenClaw 侧配置#

定时任务在 OpenClaw 网关配置 YAML 的 cron 部分中定义。每个任务包含调度表达式（cron 语法）、目标 Agent 和要执行的命令或提示词。任务在网关级别运行，由内置调度器管理。

注意：定时任务是网关全局的，不是 Agent 维度的。cron.list 和 cron.runs RPC 方法在网关级别操作，不接受 agentId 参数。向这些方法传递 agentId 会导致错误。

• -cron.list — 返回调度器状态和所有已配置的任务，包括调度表达式、下次运行时间和启用状态
• -cron.runs — 返回执行历史，包含每次运行的状态、耗时和错误详情
• -调度表达式遵循标准 cron 语法（如 '0 */6 * * *' 表示每 6 小时，'0 9 * * 1-5' 表示工作日 9 点）

使用反馈#

同步后，定时任务页面会显示：

• -调度器状态，显示 cron 调度器是否活跃以及已配置的任务总数
• -任务列表，包含名称、调度表达式、下次运行时间、上次运行时间和成功率百分比
• -运行历史时间线，包含执行状态（成功、失败、跳过）、耗时和错误日志
• -当任务连续失败超过配置阈值时显示故障告警横幅

Web 端操作#

从侧边栏的「洞察」区域导航至定时任务页面。

任务列表

任务列表展示所有已连接网关的定时任务。每行显示任务名称、cron 调度表达式、启用/禁用状态、下次计划运行时间、上次执行时间和成功率指示器。成功率低的任务以橙色警告高亮显示。点击任意任务可展开其运行历史。

运行历史

运行历史面板以分页列表展示每个任务的历史执行记录。每条记录显示运行时间戳、状态徽章（成功为绿色、失败为红色、跳过为灰色）、执行耗时和错误输出。使用分页控件浏览更早的记录。失败记录包含可展开的错误日志以便调试。

故障告警

当定时任务连续失败超过配置阈值时，ClawButler 会触发故障告警（FR-208）。告警以橙色横幅形式出现在定时任务页面顶部，包含任务名称、失败次数、最后一次错误信息和运行历史链接。当任务再次成功执行时，告警自动消除。

创建 / 编辑任务

按 Agent 创建新的定时任务或编辑现有任务。表单包含任务名称、目标 Agent、调度表达式（附带未来 5 次运行时间的可读预览）和要执行的命令或提示词。保存后变更会同步到 OpenClaw 网关。

CLI 端操作#

列出所有定时任务，包含调度器状态、调度表达式和成功率

$ ap cron list

查看定时任务的执行历史，包含状态、耗时和错误详情

$ ap cron runs

移动端操作#

在移动端，定时任务位于「更多」标签页。点击「定时任务」查看任务列表和运行历史。

• -任务列表显示名称、调度时间和成功率，带颜色编码指示器
• -点击任务查看运行历史，带状态徽章和时间戳
• -下拉刷新重新加载任务状态和最新运行数据

常见问题#