ClearClaw 定时任务完整教程:用 Cron 提示词让编程代理每天主动汇报工作进度
ClearClaw 定时任务完整教程:用 Cron 提示词让编程代理每天主动汇报工作进度
ClearClaw 是一款让你用手机和编程代理聊天的开源工具,它的定时任务功能可以通过一句 Cron 提示词,让 AI 代理每天定时主动干活并汇报工作进度,无需你手动发消息。
本文带你从零上手 ClearClaw 定时任务:创建、管理、时区设置,一步到位。
什么是 ClearClaw 定时任务?
普通用法是你发消息、代理回复。而定时任务反过来——到点由代理自己发起一轮对话,执行你预先写好的"提示词",然后把结果发到你的聊天里。
底层机制很简单:
- ⏰ 调度器基于 croner 库管理 Cron 计时器,支持标准 cron 表达式,也支持一次性时间戳
- 每个定时任务 = 一条 Cron 表达式 + 一段提示词,持久化保存在
~/.clearclaw/config.json的schedules字段中(数据结构见 ScheduleEntry) - 到点后,系统向代理注入这段提示词,代理以自己的身份完成工作,回复照常发到你的对话
- 全程无需写代码:你在聊天里说一句"每天 9 点给我汇报进度",代理自己会调用调度工具把任务建好
相关设计文档:2026-04-17-scheduler.md
3 步创建每日进度汇报任务
第 1 步:安装并启动 ClearClaw
npm install -g clearclaw
clearclaw setup
clearclaw daemon
按提示完成配对后,你就有了一个可以私聊的编程代理。
第 2 步:用自然语言描述你的任务
直接在聊天里说,例如:
每天早上 9 点,总结我项目里过去 24 小时的代码变更,把进度和风险点汇报给我
代理会调用 schedule_create 工具(实现见 orchestrator.ts),自动把"每天 9 点"翻译成 Cron 表达式 0 9 * * *,并把你的话作为定时提示词保存。
第 3 步:确认创建成功
代理会回复类似 Schedule "a1b2c3d4" created: 0 9 * * * 的确认信息。到点后,你会在聊天里收到第一条自动汇报——此后每天都在此会话中继续跟进,上下文是连贯的。
Cron 表达式速查表:5 个高频场景
| 你说的话 | Cron 表达式 | 含义 |
|---|---|---|
| 每天 9 点汇报进度 | 0 9 * * * |
每日固定时间 |
| 工作日早上 9 点站会提醒 | 0 9 * * 1-5 |
周一至周五 |
| 每小时检查一次构建状态 | 0 * * * * |
整点触发 |
| 每天早 9 点和晚 6 点两次汇报 | 0 9,18 * * * |
一天多个时间点 |
| 下周三 15 点提醒我评审 PR | 2026-05-03T15:00:00 |
一次性时间戳,触发后自动删除 |
💡 小技巧:定时任务支持指定 IANA 时区(如 Asia/Shanghai),不填则跟随系统时区。跨时区使用时在聊天里说明即可,代理会带上 timezone 参数。
4 个开箱即用的定时提示词模板
- 📊 每日进度汇报:"总结过去 24 小时的项目改动,列出已完成、进行中、风险项,控制在 10 行内"
- 🧪 定时跑测试:"运行完整测试套件,有失败用例时列出失败详情,全部通过就只报一句 OK"
- ⚠️ 依赖巡检:"检查项目依赖是否有安全更新,有则列出可升级的包和版本"
- ⏰ 一次性提醒:"下午 3 点提醒我去评审那个支付模块的 PR"(自动识别为一次性任务,触发后即删除,无需手动清理)
定时任务的日常管理
管理操作同样全部用聊天完成,对应 4 个工具:
| 操作 | 工具 | 聊天示例 |
|---|---|---|
| 创建 | schedule_create |
"每周五 18 点生成周报" |
| 查看 | schedule_list |
"我现在有哪些定时任务?" |
| 暂停/启用 | schedule_toggle |
"暂停那个跑测试的任务" |
| 删除 | schedule_delete |
"把周报任务删掉" |
任务列表、启用状态、Cron 表达式一目了然,全部记录在 config.json 中,随时可以备份或迁移。
使用注意事项
- 错过不补跑:如果到点时 daemon 没在运行,这次执行直接跳过,不会补发。建议用 systemd 之类的机制保证
clearclaw daemon常驻。 - 执行位置:定时任务统一在 home 工作区(你的私聊)中执行,走正常的消息队列——如果当时代理正忙,会排队等待。
- 失败处理:某次执行失败会记日志并通知聊天,但不会自动重试。
- 权限模式:定时触发的一轮以 assistant 模式运行(自动放行工具权限),适合汇报、巡检这类只读任务;如需改动代码,建议让代理在提示词里明确"只汇报、不修改"。
相关文件索引
| 文件 | 说明 |
|---|---|
| src/scheduler.ts | 调度器核心:Cron 计时器生命周期管理 |
| src/orchestrator.ts | 调度 MCP 工具定义(create / list / delete / toggle) |
| src/config.ts | 定时任务数据结构与配置读写 |
| docs/specs/2026-04-17-scheduler.md | 调度器完整设计文档 |
| docs/ARCHITECTURE.md | ClearClaw 整体架构 |
现在就试试吧:启动 ClearClaw,给它一条 Cron 提示词,明天这个时候,工作进度会准时出现在你的聊天里。
登录后查看全文