SuperAPI AI 工具集

openclaw-cron

办公与效率

查看项目

更新于 10-16 00:00

技能介绍

用途:通过命令行安全地管理 OpenClaw 定时任务,避免直接修改配置文件。

主要能力:列出任务(openclaw cron list,可加 --json);新增任务(openclaw cron add);立即测试运行(openclaw cron run <job-id>);启用/禁用(openclaw cron enable/disable <job-id>);查看状态与运行历史(openclaw cron status、openclaw cron runs <job-id>);编辑(openclaw cron edit <job-id>);删除(openclaw cron rm <job-id>)。

调度方式:--cron 使用 5 段 cron 表达式(分 时 日 月 周),--every 设置间隔(如 10m、1h、1d),--at 设置一次性时间(ISO 时间戳或 +20m),--tz 指定 IANA 时区(如 Asia/Shanghai)。

任务配置:--agent 指定执行代理(默认 main),--session 选择 main 或 isolated(默认 isolated),--model 覆盖模型,--message 提供任务内容,--system-event 提供系统事件,--announce 发送结果摘要,--channel 与 --to 指定通知渠道和目标,--no-deliver 关闭通知,--disabled 创建时禁用,--delete-after-run 一次性任务成功后自动删除,--timeout-seconds 设置超时(默认 30),--thinking 设置思考级别。

适用场景:每日检查、周报、每小时检查、一次性提醒、备份、GitHub 活动汇总等。

限制与建议:不要直接编辑 openclaw.json,应使用 CLI;cron 表达式建议配合时区使用;启用前先用 cron run 测试;默认会话为 isolated,除非需要对话上下文否则不建议用 main;避免创建过多高频任务。官方文档见 https://docs.openclaw.ai/cli/cron,cron 表达式测试见 https://crontab.guru。