OpenClaw人人养虾：openclaw cron

2026-05-03阅读 0热度 0

OpenClaw

管理 Agent 的定时任务（Cron Jobs），支持按计划自动触发 Agent 执行指定指令

想让你的Agent在后台自动、准时地执行重复性任务吗？定时任务（Cron Jobs）功能就是为此而生。它允许你设定一个时间计划，让指定的Agent像一位不知疲倦的助手，在预定时间自动执行你交代的指令，彻底解放你的双手。

命令签名

所有定时任务的管理，都围绕一个核心命令展开：

openclaw cron <子命令> [选项]

子命令

这套工具提供了从创建到维护的全套子命令，具体如下：

子命令	说明
`add`	添加新的定时任务
`list`	列出所有定时任务
`edit`	编辑已有的定时任务
`run`	手动触发执行一次
`runs`	查看任务执行历史
`remove`	删除定时任务

openclaw cron add

这是你创建新定时任务的起点。通过几个必要的选项，就能设定一个自动化的工作流。

openclaw cron add [选项]

选项	类型	说明
`--name`	string	任务名称（必填）
`--cron`	string	Cron 表达式（必填）
`--message`	string	发送给 Agent 的指令（必填）
`--agent`	string	指定执行的 Agent（默认 `default`）
`--enabled`	boolean	创建后立即启用（默认 `true`）

openclaw cron list

想要一目了然地掌握所有已配置的定时任务？这个命令会给你一份清晰的清单，包括下次执行时间和当前状态。

openclaw cron list [--json]

输出示例：

ID          NAME        CRON        NEXT RUN        STATUS
cron_001    日报生成    0 7 * * *   2024-01-15 07:00 enabled
cron_002    数据清理    0 2 * * 0   2024-01-21 02:00 enabled
cron_003    周报汇总    0 9 * * 1   2024-01-22 09:00 disabled

openclaw cron edit

计划有变？任务指令需要调整？使用编辑命令，可以随时修改已有任务的任何配置。

openclaw cron edit --id  [选项]

它支持与 add 命令相同的选项来修改对应字段，非常灵活。

openclaw cron run

有时你可能需要立即测试一下任务，或者临时手动触发一次，而不想等到预设的下次执行时间。这个命令正好派上用场。

openclaw cron run --id

放心，手动触发不会影响它原有的定时计划。

openclaw cron runs

任务执行得怎么样？是否成功？查看执行历史记录，是进行问题排查和效果追踪的关键。

openclaw cron runs --id  [选项]

选项	类型	说明
`--limit`	number	显示最近 N 条记录（默认 `10`）
`--json`	boolean	JSON 格式输出

openclaw cron remove

当一个定时任务完成了它的使命，或者不再需要时，可以使用删除命令将其清理掉。

openclaw cron remove --id  [--force]

示例

光看理论可能有点抽象，下面通过一组连贯的示例，带你快速上手：

# 添加每天早上 7 点执行的任务
openclaw cron add --name “日报生成” --cron “0 7 * * *” --message “生成今日工作日报”

# 添加每周一上午 9 点的周报任务
openclaw cron add --name “周报汇总” --cron “0 9 * * 1” --message “汇总本周数据并生成周报”

# 查看所有任务
openclaw cron list

# 手动触发一次
openclaw cron run --id cron_001

# 查看执行历史
openclaw cron runs --id cron_001 --limit 5

# 删除任务
openclaw cron remove --id cron_003

Cron 表达式参考

定时任务的核心在于Cron表达式。它由五个时间字段组成，分别代表分、时、日、月、周。其格式如下：

┌────────── 分钟 (0-59)
│ ┌──────── 小时 (0-23)
│ │ ┌────── 日 (1-31)
│ │ │ ┌──── 月 (1-12)
│ │ │ │ ┌── 星期 (0-7, 0和7=周日)
│ │ │ │ │
* * * * *

几个常用的表达式例子：

表达式	说明
`0 7 * * *`	每天早上 7:00
`/30 * * *`	每 30 分钟
`0 9 * * 1`	每周一 9:00
`0 2 * * 0`	每周日凌晨 2:00

《DeepSeek高效数据分析：从数据清洗到行业案例》聚焦DeepSeek在数据分析领域的高效应用，是系统讲解其从数据处理到可视化全流程的实用指南。作者结合多年职场实战经验，不仅深入拆解DeepSeek数据分析的核心功能——涵盖数据采集、清洗、预处理、探索分析、建模（回归、聚类、时间序列等）及模型评估，更通过金融量化数据分析、电商平台数据分析等真实行业案例，搭配报告撰写技巧，提供独到见解与落地建议。助力职场人在激烈竞争中凭借先进技能突破瓶颈，实现职业进阶，开启发展新篇。