ClearClaw 定时任务完整教程:用 Cron 提示词让编程代理每天主动汇报工作进度

原创2026-10-26 11:38:401,679 阅读

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 中,随时可以备份或迁移。

使用注意事项

  1. 错过不补跑:如果到点时 daemon 没在运行,这次执行直接跳过,不会补发。建议用 systemd 之类的机制保证 clearclaw daemon 常驻。
  2. 执行位置:定时任务统一在 home 工作区(你的私聊)中执行,走正常的消息队列——如果当时代理正忙,会排队等待。
  3. 失败处理:某次执行失败会记日志并通知聊天,但不会自动重试。
  4. 权限模式:定时触发的一轮以 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 提示词,明天这个时候,工作进度会准时出现在你的聊天里。

登录后查看全文
clearclaw