openclaw cron으로 Gateway 스케줄러 관리하기

반복되는 작업을 자동화하는 것은 개발자의 숙명이지만, 정작 cron job을 관리하다 보면 설정이 꼬이거나 실행 로그를 확인하기 어려워 스트레스를 받을 때가 많죠. Gateway 스케줄러를 활용하면 이런 번거로운 작업들을 훨씬 직관적으로 제어할 수 있습니다.

openclaw cron

Gateway 스케줄러를 위한 cron job 관리 방법을 알아볼게요.

관련 문서:

• Cron jobs: Cron jobs

팁: 전체 명령어 구성을 확인하려면 openclaw cron --help를 실행해 보세요.

참고: 개별적으로 추가한 cron add 작업은 기본적으로 --announce 방식으로 결과가 전달돼요. 출력을 내부용으로만 유지하고 싶다면 --no-deliver 옵션을 사용하세요. --deliver는 이전에 사용하던 별칭이며 현재는 권장되지 않아요.

참고: 일회성(--at) 작업은 실행에 성공하면 기본적으로 삭제돼요. 작업을 계속 남겨두고 싶다면 --keep-after-run 옵션을 추가하세요.

참고: CLI에서 일회성 작업을 만들 때 오프셋이 없는 --at 날짜/시간은 UTC로 처리돼요. 특정 지역의 시간을 기준으로 삼고 싶다면 --tz <iana> 옵션을 함께 전달해 주세요.

참고: 반복 작업 중에 연속으로 에러가 발생하면 지수 백오프(exponential retry backoff) 방식에 따라 재시도 간격이 늘어나요(30초 → 1분 → 5분 → 15분 → 60분). 이후 작업이 성공하면 다시 정상 스케줄로 돌아옵니다.

참고: openclaw cron run 명령은 수동 실행이 대기열에 추가되는 즉시 응답을 반환해요. 성공적인 응답에는 { ok: true, enqueued: true, runId }가 포함되며, 최종 결과는 openclaw cron runs --id <job-id> 명령으로 추적할 수 있어요.

참고: 데이터 보관 및 정리 설정은 config에서 제어할 수 있어요:

• cron.sessionRetention (기본값 24h): 완료된 개별 실행 세션을 정리해요.
• cron.runLog.maxBytes + cron.runLog.keepLines: ~/.openclaw/cron/runs/<jobId>.jsonl 파일의 크기를 관리해요.

업그레이드 참고 사항: 현재의 전달/저장 형식 이전의 오래된 cron job이 있다면 openclaw doctor --fix를 실행해 보세요. Doctor 기능이 레거시 필드(jobId, schedule.cron, threadId 등)를 표준화하고, notify: true로 설정된 단순 웹훅 작업들을 명시적인 웹훅 전달 방식으로 마이그레이션해 줍니다.

자주 사용하는 수정 명령어

메시지 내용은 그대로 두고 전달 설정만 업데이트하는 방법이에요:

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

개별 작업의 전달 기능을 비활성화할 때는 이렇게 입력하세요:

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

개별 작업에 가벼운 bootstrap context를 활성화하는 방법이에요:

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

특정 채널로 결과를 알리도록 수정할 수 있어요:

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

가벼운 bootstrap context를 사용하는 개별 작업을 새로 만드는 예시예요:

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

--light-context 옵션은 개별 agent-turn 작업에만 적용돼요. cron 실행 시 이 모드를 사용하면 전체 workspace bootstrap 세트를 주입하는 대신 bootstrap context를 비워두어 가볍게 유지합니다.

AI Setup Assistant

다음 단계

• Cron jobs 상세 가이드
• Gateway 설정 최적화