openclaw cron

게이트웨이 스케줄러의 cron 작업을 관리합니다.

관련 문서:

팁: openclaw cron --help를 실행하면 전체 명령어를 확인할 수 있습니다.

참고: 격리된 cron add 작업은 기본적으로 --announce 전달을 사용합니다. 출력을 내부에 유지하려면 --no-deliver를 사용하세요. --deliver--announce의 더 이상 사용되지 않는 별칭으로 남아 있습니다.

참고: 일회성(--at) 작업은 성공 후 기본적으로 삭제됩니다. --keep-after-run을 사용하면 유지됩니다.

참고: 반복 작업은 연속 오류 후 지수적 재시도 백오프를 사용합니다(30초 → 1분 → 5분 → 15분 → 60분). 다음 성공적인 실행 후 정상 일정으로 돌아갑니다.

참고: openclaw cron run은 이제 수동 실행이 실행 큐에 등록되면 즉시 반환합니다. 성공 응답에는 { ok: true, enqueued: true, runId }가 포함됩니다. 최종 결과를 확인하려면 openclaw cron runs --id <job-id>를 사용하세요.

참고: 보존/정리는 설정에서 제어됩니다:

  • cron.sessionRetention (기본값 24h)은 완료된 격리 실행 세션을 정리합니다.
  • cron.runLog.maxBytes + cron.runLog.keepLines~/.openclaw/cron/runs/<jobId>.jsonl을 정리합니다.

업그레이드 참고: 현재 전달/저장 형식 이전의 오래된 cron 작업이 있는 경우, openclaw doctor --fix를 실행하세요. Doctor는 이제 레거시 cron 필드(jobId, schedule.cron, 최상위 전달 필드, 페이로드 provider 전달 별칭)를 정규화하고 cron.webhook이 구성된 경우 단순한 notify: true 웹훅 폴백 작업을 명시적 웹훅 전달로 마이그레이션합니다.

일반 편집

메시지를 변경하지 않고 전달 설정 업데이트:

openclaw cron edit <job-id> --announce --channel telegram --to "123456789"

격리된 작업의 전달 비활성화:

openclaw cron edit <job-id> --no-deliver

격리된 작업에 대한 경량 부트스트랩 컨텍스트 활성화:

openclaw cron edit <job-id> --light-context

특정 채널로 공지:

openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"

경량 부트스트랩 컨텍스트로 격리된 작업 생성:

openclaw cron add \
  --name "Lightweight morning brief" \
  --cron "0 7 * * *" \
  --session isolated \
  --message "Summarize overnight updates." \
  --light-context \
  --no-deliver

--light-context는 격리된 에이전트 턴 작업에만 적용됩니다. cron 실행에서 경량 모드는 전체 워크스페이스 부트스트랩 세트를 주입하는 대신 부트스트랩 컨텍스트를 비워둡니다.