자동화 문제 해결
스케줄러 및 전달 문제(cron + heartbeat)에 대해 이 페이지를 사용하십시오.
명령 사다리
bash
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe그런 다음 자동화 검사를 실행합니다.
bash
openclaw cron status
openclaw cron list
openclaw system heartbeat last크론이 실행되지 않음
bash
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→ config/env에서 cron이 비활성화되었습니다.cron: timer tick failed→ 스케줄러 틱이 충돌했습니다. 주변 스택/로그 컨텍스트를 검사합니다.- 실행 출력의
reason: not-due→--force없이 수동 실행이 호출되고 작업이 아직 마감되지 않았습니다.
크론이 실행되었지만 전달되지 않음
bash
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
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
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가 잘못되어 낮에는 항상 하트비트가 건너뛰었습니다.
관련 항목: