QuotaCheap Playbook

OpenClaw Cron và Heartbeat: automation định kỳ cho AI agent mà không spam user

Hướng dẫn OpenClaw cron và heartbeat: scheduled jobs, HEARTBEAT.md, isolated sessions, delivery, run history, timeout, NO REPLY và QuotaCheap usage/cost vi…

Cron dùng cho scheduled jobs có lịch rõ, delivery rõ, run history rõ. Heartbeat dùng cho kiểm tra nhẹ theo ngữ cảnh, biết im lặng khi không có gì đáng nói.

Playbook tiếng Việt về OpenClaw cron và heartbeat: khi dùng cron, khi dùng heartbeat, isolated sessions, delivery modes, one-shot/recurring jobs, manual runs, failure alerts, HEARTBEAT.md, quiet replies và QuotaCheap usage/cost visibility.

Không phải AI agent nào cũng nên chờ user nhắn.

Có những việc nên tự chạy: morning brief, kiểm tra queue, tổng hợp deploy, nhắc lịch, đọc inbox, kiểm tra lỗi, hoặc gửi report cuối ngày.

Nhưng automation định kỳ cũng là nơi agent dễ biến thành máy spam nếu bạn thiết kế sai.

Trong OpenClaw, hai pattern cần phân biệt là cron và heartbeat .

Cron là scheduler: job có lịch, có run history, có delivery mode, có failure path.

Heartbeat là nhịp kiểm tra nhẹ trong đời sống của agent: đọc checklist nhỏ, nhìn context gần đây, làm vài check định kỳ, và im lặng nếu không có gì đáng nói.

Nếu dùng cron cho mọi thứ, bạn tạo cả đống job rời rạc.

Nếu dùng heartbeat cho việc cần đúng giờ, bạn nhận report trễ rồi tự hỏi tại sao.

Lỗi không nằm ở model; lỗi nằm ở việc chọn sai cơ chế.

Cron và heartbeat giải quyết hai bài toán khác nhau Rule thực tế: Dùng cron khi: cần chạy đúng lịch, ví dụ 7:00 sáng mỗi ngày; task nên cô lập khỏi main chat history; output cần gửi trực tiếp về một channel/webhook; cần run history để debug; cần failure notification; task có thể xem như một execution độc lập.

Dùng heartbeat khi: nhiều check nhỏ có thể gom vào một nhịp; timing không cần chính xác từng phút; agent cần dựa vào ngữ cảnh hội thoại gần đây; muốn giảm số lượng cron jobs; nếu không có gì mới thì nên im lặng.

Một ví dụ dễ hiểu: “mỗi ngày 8h gửi báo cáo doanh thu” là cron.

“thỉnh thoảng xem có email/calendar/weather gì đáng nhắc không” là heartbeat.

Cron trong OpenClaw là Gateway scheduler CLI docs mô tả openclaw cron là công cụ quản lý cron jobs cho Gateway scheduler.

Các command chính: Docs cũng ghi openclaw cron create là alias của openclaw cron add.

Với job mới, đặt schedule trước, prompt sau: Điểm quan trọng: cron không chỉ là “nhắc model chạy prompt”.

Nó là một control plane nhỏ cho scheduled work: schedule, session, delivery, run history, model selection, retries và failure behavior.

Agent cron job hay command cron job?

OpenClaw cron có hai kiểu tư duy.

Kiểu thứ nhất là isolated agent/model run: cron khởi động một lượt agent để làm việc có reasoning, tools và output tự nhiên.

Kiểu thứ hai là command job deterministic hơn, dùng command để chạy shell style job trong OpenClaw cron mà không start isolated agent/model run: Docs nói command jobs là admin authored Gateway automation.

Scheduled run sau đó chạy trong Gateway process, không phải model visible tools.exec call.

Command jobs capture stdout/stderr, record cron history, và route output qua delivery modes như announce, webhook, hoặc none.

Nếu output chỉ là NO REPLY, delivery bị suppress.