Xử lý sự cố tự động hóa¶

Sử dụng trang này cho các vấn đề về bộ lập lịch và gửi (cron + heartbeat).

Thang lệnh¶

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Sau đó chạy các kiểm tra tự động hóa:

openclaw cron status
openclaw cron list
openclaw system heartbeat last

Cron không kích hoạt¶

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow

Đầu ra tốt trông như sau:

• cron status báo cáo đã bật và có nextWakeAtMs trong tương lai.
• Job được bật và có lịch/múi giờ hợp lệ.
• cron runs hiển thị ok hoặc lý do bỏ qua rõ ràng.

Dấu hiệu thường gặp:

• cron: scheduler disabled; jobs will not run automatically → cron bị tắt trong cấu hình/biến môi trường.
• cron: timer tick failed → nhịp bộ lập lịch bị lỗi; kiểm tra ngữ cảnh stack/log xung quanh.
• reason: not-due trong đầu ra chạy → chạy thủ công được gọi mà không có --force và job chưa đến hạn.

Cron đã chạy nhưng không có gửi¶

openclaw cron runs --id <jobId> --limit 20
openclaw cron list
openclaw channels status --probe
openclaw logs --follow

Đầu ra tốt trông như sau:

• Trạng thái chạy là ok.
• Chế độ/đích gửi được thiết lập cho các job cô lập.
• Kiểm tra kênh báo cáo kênh đích đã kết nối.

Dấu hiệu thường gặp:

• Chạy thành công nhưng chế độ gửi là none → không mong đợi có thông báo bên ngoài.
• Thiếu/không hợp lệ đích gửi (channel/to) → chạy có thể thành công nội bộ nhưng bỏ qua gửi ra ngoài.
• Lỗi xác thực kênh (unauthorized, missing_scope, Forbidden) → gửi bị chặn bởi thông tin xác thực/quyền của kênh.

Heartbeat bị chặn hoặc bỏ qua¶

openclaw system heartbeat last
openclaw logs --follow
openclaw config get agents.defaults.heartbeat
openclaw channels status --probe

Đầu ra tốt trông như sau:

• Heartbeat được bật với khoảng thời gian khác 0.
• Kết quả heartbeat gần nhất là ran (hoặc lý do bỏ qua đã được hiểu rõ).

Dấu hiệu thường gặp:

• heartbeat skipped với reason=quiet-hours → nằm ngoài activeHours.
• requests-in-flight → luồng chính bận; heartbeat bị hoãn.
• empty-heartbeat-file → HEARTBEAT.md tồn tại nhưng không có nội dung có thể hành động.
• alerts-disabled → cài đặt hiển thị chặn các thông báo heartbeat gửi ra ngoài.

Những điểm dễ sai về múi giờ và activeHours¶

openclaw config get agents.defaults.heartbeat.activeHours
openclaw config get agents.defaults.heartbeat.activeHours.timezone
openclaw config get agents.defaults.userTimezone || echo "agents.defaults.userTimezone not set"
openclaw cron list
openclaw logs --follow

Quy tắc nhanh:

• Config path not found: agents.defaults.userTimezone nghĩa là khóa chưa được đặt; heartbeat quay về múi giờ của máy chủ (hoặc activeHours.timezone nếu được đặt).
• Cron không có --tz sẽ dùng múi giờ của máy chủ gateway.
• activeHours của heartbeat dùng phân giải múi giờ đã cấu hình (user, local, hoặc IANA tz tường minh).
• Dấu thời gian ISO không có múi giờ được coi là UTC cho các lịch cron at.

Dấu hiệu thường gặp:

• Job chạy sai thời điểm theo đồng hồ sau khi múi giờ máy chủ thay đổi.
• Heartbeat luôn bị bỏ qua vào ban ngày của bạn vì activeHours.timezone sai.

Liên quan:

• /automation/cron-jobs
• /gateway/heartbeat
• /automation/cron-vs-heartbeat
• /concepts/timezone