명령 개요
openclaw cron 명령은 OpenClaw의 예약 작업 시스템을 관리하는 데 사용됩니다. 예약 메시지 발송, 주기적 AI 작업 실행, 자동화 워크플로 트리거를 설정할 수 있습니다.
예약 작업 조회
openclaw cron list
Cron Jobs:
ID Schedule Channel Status Description
──────────────────────────────────────────────────────────────────
daily-news 0 8 * * * telegram-main Active 일일 뉴스 요약
weekly-rpt 0 9 * * 1 slack-team Active 주간 보고서 생성
health-chk */5 * * * * - Active 시스템 상태 점검
birthday 0 10 * * * telegram-main Active 생일 알림
예약 작업 생성
대화형 생성
openclaw cron add
명령줄 생성
# 매일 아침 8시에 뉴스 요약 발송
openclaw cron add daily-news \
--schedule "0 8 * * *" \
--channel telegram-main \
--prompt "오늘의 기술 뉴스를 검색하여 간략한 요약을 생성해주세요" \
--tools web_search
# 매주 월요일 아침 9시에 주간 보고서 생성
openclaw cron add weekly-report \
--schedule "0 9 * * 1" \
--channel slack-team \
--prompt "이번 주의 프로젝트 진행 상황을 요약하여 주간 보고서를 생성해주세요" \
--model gpt-4o
# 5분마다 시스템 상태 점검
openclaw cron add health-monitor \
--schedule "*/5 * * * *" \
--action health-check \
--notify-on-failure telegram-admin
Cron 표현식
┌───────────── 분 (0-59)
│ ┌───────────── 시 (0-23)
│ │ ┌───────────── 일 (1-31)
│ │ │ ┌───────────── 월 (1-12)
│ │ │ │ ┌───────────── 요일 (0-7, 0과 7은 일요일)
│ │ │ │ │
* * * * *
자주 사용하는 표현식:
| 표현식 | 의미 |
|---|---|
0 8 * * * |
매일 8:00 |
0 */2 * * * |
2시간마다 |
0 9 * * 1 |
매주 월요일 9:00 |
0 0 1 * * |
매월 1일 0:00 |
*/5 * * * * |
5분마다 |
0 8,12,18 * * * |
매일 8/12/18시 |
약식도 지원됩니다:
openclaw cron add task --schedule "@daily" # 매일 0:00
openclaw cron add task --schedule "@hourly" # 매시간
openclaw cron add task --schedule "@weekly" # 매주 일요일 0:00
작업 유형
AI 메시지 작업
AI가 메시지를 생성하여 발송합니다:
openclaw cron add morning-greeting \
--schedule "0 8 * * *" \
--channel telegram-main \
--prompt "친근한 방식으로 좋은 아침 인사를 해주세요. 명언을 하나 포함해도 좋습니다"
시스템 작업
시스템 유지보수 작업을 실행합니다:
# 만료된 세션 정기 정리
openclaw cron add cleanup \
--schedule "0 3 * * *" \
--action sessions-cleanup \
--args "--older-than 7d"
# 정기 백업
openclaw cron add backup \
--schedule "0 2 * * *" \
--action backup \
--args "--output /backups/"
Webhook 트리거 작업
외부 API를 주기적으로 호출합니다:
openclaw cron add api-check \
--schedule "*/10 * * * *" \
--action webhook \
--url "https://api.example.com/status" \
--notify-on-failure telegram-admin
작업 관리
# 작업 일시정지
openclaw cron pause daily-news
# 작업 재개
openclaw cron resume daily-news
# 즉시 한 번 실행
openclaw cron run daily-news
# 스케줄 수정
openclaw cron update daily-news --schedule "0 9 * * *"
# 작업 삭제
openclaw cron delete old-task
실행 로그 조회
openclaw cron logs daily-news
openclaw cron logs daily-news --last 10
Execution Log: daily-news
[2026-03-18 08:00:01] ✓ Completed (2.5s) - Message sent
[2026-03-17 08:00:01] ✓ Completed (3.1s) - Message sent
[2026-03-16 08:00:02] ✗ Failed - Provider timeout
[2026-03-15 08:00:01] ✓ Completed (1.8s) - Message sent
시간대 설정
# 전역 시간대 설정
openclaw cron set-timezone "Asia/Seoul"
# 특정 작업에 시간대 설정
openclaw cron update daily-news --timezone "America/New_York"
정리
openclaw cron은 AI 어시스턴트가 수동 응답에만 머무르지 않고 주기적인 작업을 능동적으로 수행할 수 있게 합니다. 일일 뉴스 발송부터 시스템 유지보수까지, 예약 작업은 OpenClaw의 자동화 능력을 크게 확장합니다.