🦞 06. CronJob

Agent/🚀 OpenClaw/images/openclaw-06-cronjob-diagram.svg

이 문서는 CronJob을 **유저 관점(무엇을 말하면 되는지)**과 **OpenClaw 관점(내부 경로/양식)**으로 나눠서 정리합니다.

AI 활용 안내: 이 문서는 생성형 AI 보조를 받아 작성되었습니다.

---

먼저 답: 링크만 주면 자동 설정되나?

짧게 말하면 링크만으로는 자동 설정되지 않습니다.

• 링크 + 목적을 같이 주면 설정 가능
• 예: “이 링크 참고해서 매일 오전 7시에 요약 보내는 cron 잡 설정해줘”

즉, 유저가 JSON을 다 이해하지 않아도 됩니다. 원하는 동작만 말하면 되고, OpenClaw가 내부 양식으로 변환해 설정하면 됩니다.

---

1) 유저 관점: 이렇게 말하면 된다 (명령어/요청문)

A. 채팅에서 바로 요청 (가장 쉬운 방법)

1) "20분 뒤에 회의 준비하라고 리마인드 cron 잡 만들어줘"
2) "매일 오전 7시에 AI 뉴스 브리핑 cron으로 보내줘"
3) "30분마다 교육요청 메일 체크해서 새 메일만 알려줘"
4) "등록된 cron 목록 보여줘"
5) "OOO 잡 지금 한 번 강제 실행해줘"
6) "OOO 잡 비활성화/삭제해줘"

B. 터미널 CLI로 직접 실행 (선택)

openclaw cron list
openclaw cron run <job-id>
openclaw cron runs --id <job-id>
openclaw cron remove --id <job-id>

자주 쓰는 추가 예시:

# 매일 07:00, isolated 실행 + 전달
openclaw cron add \
  --name "Morning brief" \
  --cron "0 7 * * *" \
  --tz "Asia/Seoul" \
  --session isolated \
  --message "오늘의 AI 뉴스 3개를 요약해줘" \
  --announce
 
# 1회성 리마인더
openclaw cron add \
  --name "Call back" \
  --at "2026-02-19T01:00:00Z" \
  --session main \
  --system-event "리마인더: 고객 콜백"

---

2) OpenClaw 관점: 설정 매뉴얼 (경로 + 양식)

2-1. 저장 경로

Cron Job은 Gateway 호스트에 영구 저장됩니다.

• 기본 경로: ~/.openclaw/cron/jobs.json

주의:

• 수동 편집은 Gateway 중지 상태에서만 안전
• 일반적으로는 openclaw cron ... 또는 cron tool 호출 사용 권장

2-2. 핵심 구조

flowchart LR
  U[유저 요청] --> J[Job 생성]
  J --> S[schedule: 언제]
  J --> T[sessionTarget: 어디서]
  J --> P[payload: 무엇을]
  J --> D[delivery: 어디로 보낼지]

  T --> M[main]
  T --> I[isolated]
  M --> MS[systemEvent 필수]
  I --> IA[agentTurn 필수]

필수 필드

{
  "schedule": { ... },
  "sessionTarget": "main | isolated",
  "payload": { ... }
}

규칙(중요)

• sessionTarget: "main" 이면 payload.kind는 반드시 "systemEvent"
• sessionTarget: "isolated" 이면 payload.kind는 반드시 "agentTurn"
• delivery는 isolated job에서만 사용
• isolated에서 delivery 생략 시 기본값은 보통 announce

---

3) OpenClaw 관점: 복붙 템플릿

템플릿 A — 메인 세션(systemEvent) 1회 리마인더

{
  "name": "리마인더",
  "schedule": { "kind": "at", "at": "2026-02-19T01:00:00Z" },
  "sessionTarget": "main",
  "wakeMode": "now",
  "payload": {
    "kind": "systemEvent",
    "text": "리마인더: 10시 회의 준비 시작"
  },
  "deleteAfterRun": true
}

템플릿 B — isolated 반복 작업 + 채널 전달

{
  "name": "매일 아침 뉴스 브리핑",
  "schedule": {
    "kind": "cron",
    "expr": "0 7 * * *",
    "tz": "Asia/Seoul"
  },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "오늘의 AI/기술 핵심 뉴스 3개를 요약해서 전달해줘."
  },
  "delivery": {
    "mode": "announce",
    "channel": "telegram",
    "to": "telegram:YOUR_TELEGRAM_USER_ID"
  }
}

---

4) 운영 체크리스트 (실수 방지)

• 시간대(tz)를 명시했는가? (예: Asia/Seoul)
• main/isolated와 payload.kind 조합이 맞는가?
• 전달이 필요한 잡은 delivery를 설정했는가?
• 등록 후 list/run으로 스모크 테스트 했는가?
• 실패 시 runs --id <job-id>로 최근 실행로그를 확인했는가?

---

결론

CronJob은 “언제 + 무엇을”만 명확하면 어렵지 않습니다.

• 유저는 자연어로 요청
• OpenClaw는 내부 양식(JSON)으로 변환
• 운영자는 경로/규칙만 알면 안정적으로 유지보수 가능

---

Flux 🦞 | 2026-02-18

← Mac Mini + Ollama | Quota 관리 →

관련 글

• 🦞 25. 크론 서브에이전트 분산운영 — Cron + 서브에이전트로 작업 분산
• 16. cron 시간 변경 오류 해결 — cron 설정 트러블슈팅