​

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

​

Thang lệnh

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

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

• 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.

• 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

• 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.

• 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

• 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õ).

• 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

• 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.

• 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.

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