AI Agent定时自动化:用klaw cron轻松实现每小时、每天、每周自动任务
AI Agent定时自动化:用klaw cron轻松实现每小时、每天、每周自动任务
klaw 是一款开源的 AI Agent 管理平台(口号是 "kubectl for AI Agents"),它内置的 klaw cron 定时任务工具可以让你用一条命令,就让 AI Agent 按小时、每天或每周自动执行工作——无需第三方调度器,也几乎不需要写代码。本文带你从零开始,5 分钟内搞定第一个 AI Agent 定时自动化任务。
为什么需要 AI Agent 定时自动化?
传统方案里,定时跑 AI 任务往往要自己拼 cron + 脚本 + 告警,链路又长又容易断。而 klaw 把「调度 + Agent + 任务」整合到一条命令里:
- 🕒 声明式定时:直接说"每天早上 9 点",klaw 自动转成 cron 表达式
- ⚡ 自带调度器:随
klaw start一起运行,任务持久化保存,重启不丢 - 🤖 对话式创建:也可以直接让 AI Agent 自己调用
cron_create工具建任务
三步上手:创建第一个定时任务
第 1 步:先有一个 Agent(安装配置详见 docs/quickstart.mdx)
klaw create agent reporter --namespace ops --model claude-sonnet-4-20250514
第 2 步:创建定时任务,支持自然语言或标准 cron 两种写法:
klaw cron create daily-report \
--schedule "every day at 9am" \
--agent reporter \
--task "查询昨日核心指标,生成周报并发送到 #team-updates"
创建成功后会立即显示任务 ID、解析出的 cron 表达式和下次运行时间:
✅ Scheduled job created!
ID: a1b2c3d4
Schedule: every day at 9am
Cron: 0 9 * * *
Next Run: 2026-11-13T09:00:00+08:00
第 3 步:启动平台,调度器随平台一起跑起来:
klaw start
自然语言排期速查表(最常用写法)
这是新手最常用的长尾场景,直接照抄即可(解析逻辑见 internal/scheduler/scheduler.go):
| 你想表达的意思 | --schedule 参数写法 |
等价 cron 表达式 |
|---|---|---|
| 每 5 分钟一次 | every 5 minutes |
*/5 * * * * |
| 每小时自动运行 | every hour |
0 * * * * |
| 每 2 小时一次 | every 2 hours |
0 */2 * * * |
| 每天 / 每天早上 | daily 或 every morning |
0 9 * * * |
| 每天 9 点 | every day at 9am |
0 9 * * * |
| 每天 14:30 | every day at 14:30 |
30 14 * * * |
| 每周一早上 | every monday at 10am |
0 10 * * 1 |
| 每个工作日 | every weekday |
0 9 * * 1-5 |
| 每月 1 号 | monthly 或 first of every month |
0 9 1 * * |
| 标准 cron 写法 | 0 8 * * MON |
原样使用 |
💡 小提示:不确定的话可以先写
every day at 9am这类自然语言,klaw 会自动换算成标准 cron,创建输出里会同时展示两者,方便核对。
定时任务的日常管理命令
创建只是开始,日常运维全部由 klaw cron 子命令完成(完整参考见 docs/cli-reference/overview.mdx):
| 命令 | 作用 |
|---|---|
klaw cron list |
列出所有定时任务及下次运行时间 |
klaw cron describe <job-id> |
查看任务详情、运行次数、上次结果/错误 |
klaw cron run <job-id> |
手动立即触发一次,验证效果 |
klaw cron enable <job-id> |
启用任务 |
klaw cron disable <job-id> |
暂停任务(保留配置) |
klaw cron delete <job-id> |
删除任务 |
推荐流程:create → run 试跑一次 → list 确认排期 → 需要时 disable/delete。
3 个开箱即用的实战场景
📈 场景一:每小时自动评分新线索
klaw cron create hourly-scoring \
--schedule "every hour" \
--agent lead-scorer \
--task "检查 CRM 中新增线索,按公司规模与匹配度打 1-100 分并回写"
👀 场景二:每天竞品监控
klaw cron create daily-check \
--schedule "every day at 9am" \
--agent competitor-watch \
--task "检查竞品定价页变化,有 diff 则摘要后发到 #competitive-intel"
📊 场景三:每周自动周报
klaw cron create weekly-report \
--schedule "every monday at 8am" \
--agent reporter \
--task "查询上周核心指标,生成图表并发送到 #team-updates"
进阶:让 AI 自己帮你建定时任务
除了命令行,你还可以在对话里直接说一句"帮我建一个每天早上 9 点的任务",Agent 会自动调用内置的 cron_create 工具完成任务创建——实现逻辑见 internal/tool/cron_tool.go。它甚至支持绑定 Slack 频道(--channel 参数),让定时任务自动读取频道消息再分析。
工作原理与源码索引
klaw 的调度器每分钟巡检一次任务,到点即异步拉起对应 Agent 执行,并把运行次数、上次结果、错误信息持久化到本地,重启后自动加载(jobs.json)。核心代码位置:
- 定时任务调度器:internal/scheduler/scheduler.go
- CLI 命令实现:cmd/klaw/commands/cron.go
- AI 侧
cron_create工具:internal/tool/cron_tool.go - 官方快速上手:docs/quickstart.mdx
总结
用 klaw cron 做 AI Agent 定时自动化,只需记住一句话:给任务起个名字,说清"什么时候跑、让谁跑、跑什么"。从"每小时检查一次"到"每周一发周报",一条命令就能落地。现在就可以试试:先 klaw cron list 看看你有哪些任务,再 klaw cron create 建一个属于你的第一个自动任务吧 ✅
