> ## Documentation Index
> Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
> Use this file to discover all available pages before exploring further.

# Hướng Dẫn Khắc Phục Sự Cố Tự Động Hóa

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

Sử dụng trang này để giải quyết các vấn đề về lập lịch và gửi thông điệp (`cron` + `heartbeat`).

## Lệnh kiểm tra

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron status
openclaw cron list
openclaw system heartbeat last
```

## Cron không kích hoạt

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow
```

Kết quả tốt sẽ như sau:

* `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.

Các 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/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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw cron runs --id <jobId> --limit 20
openclaw cron list
openclaw channels status --probe
openclaw logs --follow
```

Kết quả tốt sẽ như sau:

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

Các dấu hiệu thường gặp:

* 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw system heartbeat last
openclaw logs --follow
openclaw config get agents.defaults.heartbeat
openclaw channels status --probe
```

Kết quả tốt sẽ như sau:

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

Các dấu hiệu thường gặp:

* `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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 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ác dấu hiệu thường gặp:

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

Liên quan:

* [/automation/cron-jobs](/automation/cron-jobs)
* [/gateway/heartbeat](/gateway/heartbeat)
* [/automation/cron-vs-heartbeat](/automation/cron-vs-heartbeat)
* [/concepts/timezone](/concepts/timezone)