​

Cron vs Heartbeat: Khi nào nên sử dụng

​

Hướng dẫn quyết định nhanh

​

Heartbeat: Nhận thức định kỳ

​

Khi nào nên dùng heartbeat

• Nhiều kiểm tra định kỳ: Thay vì 5 cron jobs riêng lẻ kiểm tra hộp thư, lịch, thời tiết, thông báo và trạng thái dự án, một heartbeat có thể gộp tất cả.
• Quyết định nhận biết ngữ cảnh: Agent có toàn bộ ngữ cảnh phiên chính, nên có thể đưa ra quyết định thông minh về điều gì là khẩn cấp.
• Liên tục hội thoại: Các lần chạy heartbeat chia sẻ cùng phiên, nên agent nhớ các cuộc hội thoại gần đây và có thể theo dõi tự nhiên.
• Giám sát chi phí thấp: Một heartbeat thay thế nhiều tác vụ polling nhỏ.

​

Ưu điểm của heartbeat

• Gộp nhiều kiểm tra: Một lượt agent có thể xem xét hộp thư, lịch và thông báo cùng lúc.
• Giảm cuộc gọi API: Một heartbeat rẻ hơn 5 cron jobs riêng lẻ.
• Nhận biết ngữ cảnh: Agent biết bạn đang làm gì và có thể ưu tiên phù hợp.
• Ngăn chặn thông minh: Nếu không cần chú ý, agent trả lời HEARTBEAT_OK và không có thông báo nào được gửi.
• Thời gian tự nhiên: Trôi nhẹ dựa trên tải hàng đợi, phù hợp cho hầu hết giám sát.

​

Ví dụ heartbeat: Danh sách kiểm tra HEARTBEAT.md

# Danh sách kiểm tra Heartbeat

- Kiểm tra email cho tin nhắn khẩn cấp
- Xem lịch cho sự kiện trong 2 giờ tới
- Nếu tác vụ nền hoàn thành, tóm tắt kết quả
- Nếu không hoạt động trong 8+ giờ, gửi kiểm tra ngắn

​

Cấu hình heartbeat

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // khoảng thời gian
        target: "last", // mục tiêu gửi cảnh báo rõ ràng (mặc định là "none")
        activeHours: { start: "08:00", end: "22:00" }, // tùy chọn
      },
    },
  },
}

​

Cron: Lập lịch chính xác

​

Khi nào nên dùng cron

• Cần thời gian chính xác: “Gửi cái này lúc 9:00 sáng mỗi thứ Hai” (không phải “khoảng 9 giờ”).
• Tác vụ độc lập: Tác vụ không cần ngữ cảnh hội thoại.
• Mô hình/suy nghĩ khác: Phân tích nặng cần mô hình mạnh hơn.
• Nhắc nhở một lần: “Nhắc tôi trong 20 phút” với --at.
• Tác vụ ồn ào/thường xuyên: Tác vụ sẽ làm lộn xộn lịch sử phiên chính.
• Kích hoạt bên ngoài: Tác vụ nên chạy độc lập với việc agent có hoạt động hay không.

​

Ưu điểm của cron

• Thời gian chính xác: Biểu thức cron 5 trường hoặc 6 trường (giây) với hỗ trợ múi giờ.
• Phân bổ tải tích hợp: Lịch trình định kỳ đầu giờ được phân bổ trong vòng 5 phút theo mặc định.
• Kiểm soát từng công việc: Ghi đè phân bổ với --stagger <duration> hoặc buộc thời gian chính xác với --exact.
• Cách ly phiên: Chạy trong cron:<jobId> mà không làm ô nhiễm lịch sử chính.
• Ghi đè mô hình: Sử dụng mô hình rẻ hơn hoặc mạnh hơn cho từng công việc.
• Kiểm soát gửi: Công việc riêng lẻ mặc định là announce (tóm tắt); chọn none nếu cần.
• Gửi ngay lập tức: Chế độ thông báo đăng trực tiếp mà không chờ heartbeat.
• Không cần ngữ cảnh agent: Chạy ngay cả khi phiên chính không hoạt động hoặc bị nén.
• Hỗ trợ một lần: --at cho dấu thời gian tương lai chính xác.

​

Ví dụ cron: Tóm tắt buổi sáng hàng ngày

openclaw cron add \
  --name "Tóm tắt buổi sáng" \
  --cron "0 7 * * *" \
  --tz "America/New_York" \
  --session isolated \
  --message "Tạo tóm tắt hôm nay: thời tiết, lịch, email hàng đầu, tóm tắt tin tức." \
  --model opus \
  --announce \
  --channel whatsapp \
  --to "+15551234567"

​

Ví dụ cron: Nhắc nhở một lần

openclaw cron add \
  --name "Nhắc nhở cuộc họp" \
  --at "20m" \
  --session main \
  --system-event "Nhắc nhở: cuộc họp đứng bắt đầu trong 10 phút." \
  --wake now \
  --delete-after-run

​

Sơ đồ quyết định

Tác vụ có cần chạy vào thời điểm CHÍNH XÁC không?
  CÓ -> Sử dụng cron
  KHÔNG -> Tiếp tục...

Tác vụ có cần cách ly khỏi phiên chính không?
  CÓ -> Sử dụng cron (riêng lẻ)
  KHÔNG -> Tiếp tục...

Tác vụ này có thể gộp với các kiểm tra định kỳ khác không?
  CÓ -> Sử dụng heartbeat (thêm vào HEARTBEAT.md)
  KHÔNG -> Sử dụng cron

Đây có phải là nhắc nhở một lần không?
  CÓ -> Sử dụng cron với --at
  KHÔNG -> Tiếp tục...

Có cần mô hình hoặc mức suy nghĩ khác không?
  CÓ -> Sử dụng cron (riêng lẻ) với --model/--thinking
  KHÔNG -> Sử dụng heartbeat

​

Kết hợp cả hai

1. Heartbeat xử lý giám sát định kỳ (hộp thư, lịch, thông báo) trong một lượt gộp mỗi 30 phút.
2. Cron xử lý lịch trình chính xác (báo cáo hàng ngày, đánh giá hàng tuần) và nhắc nhở một lần.

​

Ví dụ: Thiết lập tự động hóa hiệu quả

# Danh sách kiểm tra Heartbeat

- Quét hộp thư cho email khẩn cấp
- Kiểm tra lịch cho sự kiện trong 2 giờ tới
- Xem xét bất kỳ tác vụ đang chờ xử lý
- Kiểm tra nhẹ nếu yên tĩnh trong 8+ giờ

# Tóm tắt buổi sáng hàng ngày lúc 7 giờ sáng
openclaw cron add --name "Tóm tắt buổi sáng" --cron "0 7 * * *" --session isolated --message "..." --announce

# Đánh giá dự án hàng tuần vào thứ Hai lúc 9 giờ sáng
openclaw cron add --name "Đánh giá hàng tuần" --cron "0 9 * * 1" --session isolated --message "..." --model opus

# Nhắc nhở một lần
openclaw cron add --name "Gọi lại" --at "2h" --session main --system-event "Gọi lại khách hàng" --wake now

​

Lobster: Quy trình làm việc xác định với phê duyệt

​

Khi nào Lobster phù hợp

• Tự động hóa nhiều bước: Bạn cần một pipeline công cụ cố định, không phải một lời nhắc một lần.
• Cổng phê duyệt: Các tác động phụ nên tạm dừng cho đến khi bạn phê duyệt, sau đó tiếp tục.
• Chạy có thể tiếp tục: Tiếp tục một quy trình làm việc bị tạm dừng mà không chạy lại các bước trước đó.

​

Cách kết hợp với heartbeat và cron

• Heartbeat/cron quyết định khi nào một lượt chạy xảy ra.
• Lobster xác định các bước nào xảy ra khi lượt chạy bắt đầu.

​

Ghi chú vận hành (từ mã)

• Lobster chạy như một quá trình con cục bộ (lobster CLI) ở chế độ công cụ và trả về một phong bì JSON.
• Nếu công cụ trả về needs_approval, bạn tiếp tục với một resumeToken và cờ approve.
• Công cụ là một plugin tùy chọn; kích hoạt nó bổ sung qua tools.alsoAllow: ["lobster"] (khuyến nghị).
• Lobster yêu cầu CLI lobster có sẵn trên PATH.

​

Phiên chính vs Phiên riêng lẻ

​

Khi nào nên dùng cron phiên chính

• Nhắc nhở/sự kiện xuất hiện trong ngữ cảnh phiên chính
• Agent xử lý nó trong lần heartbeat tiếp theo với ngữ cảnh đầy đủ
• Không có lần chạy riêng lẻ nào

openclaw cron add \
  --name "Kiểm tra dự án" \
  --every "4h" \
  --session main \
  --system-event "Đã đến lúc kiểm tra sức khỏe dự án" \
  --wake now

​

Khi nào nên dùng cron riêng lẻ

• Một khởi đầu mới mà không có ngữ cảnh trước đó
• Cài đặt mô hình hoặc suy nghĩ khác
• Thông báo tóm tắt trực tiếp đến một kênh
• Lịch sử không làm lộn xộn phiên chính

openclaw cron add \
  --name "Phân tích sâu" \
  --cron "0 6 * * 0" \
  --session isolated \
  --message "Phân tích mã nguồn hàng tuần..." \
  --model opus \
  --thinking high \
  --announce

​

Cân nhắc chi phí

• Giữ HEARTBEAT.md nhỏ để giảm thiểu chi phí token.
• Gộp các kiểm tra tương tự vào heartbeat thay vì nhiều cron jobs.
• Sử dụng target: "none" trên heartbeat nếu bạn chỉ muốn xử lý nội bộ.
• Sử dụng cron riêng lẻ với mô hình rẻ hơn cho các tác vụ thường xuyên.

​

Liên quan

• Heartbeat - cấu hình heartbeat đầy đủ
• Cron jobs - tham chiếu CLI và API cron đầy đủ
• System - sự kiện hệ thống + điều khiển heartbeat