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

# 자동화 문제 해결

# 자동화 문제 해결

스케줄러 및 전달 문제에 대해 이 페이지를 사용하십시오 (`cron` + `heartbeat`).

## 명령 단계

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

그런 다음 자동화 점검을 실행하십시오:

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

## Cron 이 실행되지 않음

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

정상 출력은 다음과 같습니다:

* `cron status` 에서 활성화 상태와 미래의 `nextWakeAtMs` 가 보고됩니다.
* 작업이 활성화되어 있으며 유효한 스케줄/타임존을 가지고 있습니다.
* `cron runs` 에 `ok` 또는 명시적인 건너뜀 사유가 표시됩니다.

일반적인 징후:

* `cron: scheduler disabled; jobs will not run automatically` → 설정/환경 변수에서 cron 이 비활성화되어 있습니다.
* `cron: timer tick failed` → 스케줄러 틱이 충돌했습니다. 주변 스택/로그 컨텍스트를 확인하십시오.
* 실행 출력에 `reason: not-due` → `--force` 없이 수동 실행이 호출되었고 아직 작업 시점이 아닙니다.

## Cron 은 실행되었으나 전달되지 않음

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

정상 출력은 다음과 같습니다:

* 실행 상태가 `ok` 입니다.
* 격리된 작업에 대해 전달 모드/대상이 설정되어 있습니다.
* 채널 프로브에서 대상 채널이 연결되어 있다고 보고합니다.

일반적인 징후:

* 실행은 성공했으나 전달 모드가 `none` → 외부 메시지는 예상되지 않습니다.
* 전달 대상이 누락되었거나 유효하지 않음 (`channel`/`to`) → 내부적으로는 성공할 수 있으나 외부 전송을 건너뜁니다.
* 채널 인증 오류 (`unauthorized`, `missing_scope`, `Forbidden`) → 채널 자격 증명/권한으로 인해 전달이 차단되었습니다.

## 하트비트가 억제되거나 건너뜀

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

정상 출력은 다음과 같습니다:

* 하트비트가 0 이 아닌 간격으로 활성화되어 있습니다.
* 마지막 하트비트 결과가 `ran` 입니다 (또는 건너뜀 사유가 이해됩니다).

일반적인 징후:

* `heartbeat skipped` 와 `reason=quiet-hours` → `activeHours` 범위 밖입니다.
* `requests-in-flight` → 메인 레인이 바빠 하트비트가 지연되었습니다.
* `empty-heartbeat-file` → `HEARTBEAT.md` 가 존재하지만 실행 가능한 콘텐츠가 없습니다.
* `alerts-disabled` → 가시성 설정으로 인해 외부 하트비트 메시지가 억제됩니다.

## 타임존 및 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
```

빠른 규칙:

* `Config path not found: agents.defaults.userTimezone` 은 키가 설정되지 않았음을 의미합니다. 하트비트는 호스트 타임존으로 폴백됩니다 (또는 `activeHours.timezone` 가 설정된 경우 이를 사용합니다).
* `--tz` 가 없는 cron 은 게이트웨이 호스트 타임존을 사용합니다.
* 하트비트 `activeHours` 는 구성된 타임존 해석 (`user`, `local`, 또는 명시적 IANA tz) 을 사용합니다.
* 타임존이 없는 ISO 타임스탬프는 cron `at` 스케줄에 대해 UTC 로 처리됩니다.

일반적인 징후:

* 호스트 타임존 변경 후 작업이 잘못된 실제 시각에 실행됩니다.
* `activeHours.timezone` 이 잘못되어 하트비트가 주간 시간 내내 항상 건너뜁니다.

관련 항목:

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