Documentation Index

Fetch the complete documentation index at: https://openclawhub.vn/llms.txt

Use this file to discover all available pages before exploring further.

​

Khắc phục sự cố tự động hóa

​

Lệnh kiểm tra

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.
• Công việc được bật và có lịch trình/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/môi trường.
• cron: timer tick failed → tick của scheduler bị lỗi; kiểm tra ngữ cảnh stack/log xung quanh.
• reason: not-due trong kết quả chạy → chạy thủ công được gọi mà không có --force và công việc chưa đến hạn.

​

Cron kích hoạt nhưng không gửi thông điệp

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 công việc riêng lẻ.
• 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 có thông điệp bên ngoài nào được mong đợi.
• Đích gửi thiếu/hỏng (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ị ngă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 cuối cùng là ran (hoặc lý do bỏ qua được hiểu rõ).

• heartbeat skipped với reason=quiet-hours → ngoài activeHours.
• requests-in-flight → làn chính bận; heartbeat bị hoãn.
• empty-heartbeat-file → heartbeat theo khoảng thời gian bị bỏ qua vì HEARTBEAT.md không có nội dung hành động và không có sự kiện cron nào được xếp hàng.
• alerts-disabled → cài đặt hiển thị ngăn chặn thông điệp heartbeat ra ngoài.

​

Lưu ý 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 sẽ sử dụng múi giờ của máy chủ (hoặc activeHours.timezone nếu có).
• Cron không có --tz sử dụng múi giờ của máy chủ gateway.
• Heartbeat activeHours sử dụng độ phân giải múi giờ đã cấu hình (user, local, hoặc IANA tz cụ thể).
• Dấu thời gian ISO không có múi giờ được coi là UTC cho lịch trình at của cron.

• Công việc chạy sai thời gian đồng hồ sau khi múi giờ máy chủ thay đổi.
• Heartbeat luôn bị bỏ qua trong giờ làm việc của bạn vì activeHours.timezone sai.

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