OpenClaw Cron Job 설정: AI 어시스턴트가 예약 작업을 능동적으로 실행하게 만들기

OpenClaw의 Cron Job 기능을 이용하면 AI 어시스턴트가 주가 동향 보고서 정리, 중요 이메일 분석, 일기예보에 따른 스마트 홈 설정 변경 같은 작업을 능동적으로 실행할 수 있습니다. 매일 아침 OpenClaw를 열어 날씨와 일정을 묻고, 점심에는 주가를 직접 확인하며, 잠들기 전에는 문과 창문 상태를 점검하는 식의 반복 질문은 예약 작업으로 모두 자동화할 수 있습니다.

솔직히 당시에는 이런 생각이 계속 들었습니다. AI가 이렇게 똑똑한데 왜 이런 일을 먼저 처리해 줄 수 없을까? OpenClaw의 Cron Job 기능을 발견하고 나서야 ‘자율형 에이전트’가 무엇인지 제대로 체감했습니다.

저비용 ‘AI 에이전트 키우기’ 가이드: ArkClaw로 AI Agent의 진입 장벽 낮추기

최근 주목받는 OpenClaw는 유용하지만 설정 과정이 너무 복잡하다고 느끼시나요? ByteDance Volcano Engine의 ArkClaw는 그 진입 장벽을 크게 낮춥니다. 서버와 Token 설정을 따로 다루지 않아도 클릭 한 번으로 24시간 온라인 상태에서 브라우저를 제어하고 스크립트를 실행하며 캘린더를 관리하는 ‘AI 일꾼’을 사용할 수 있습니다.

가장 큰 장점은 실제로 저렴하다는 점입니다. 월 이용료는 9.9위안이며, 제 초대 코드 ZLKUK54M을 사용해 여기에서 가입하면 8.9위안입니다. 프로그래머라면 Coding Plan Pro를 통해 무료로 사용할 수도 있습니다.

AI 예약 작업이 필요한 이유

기존 AI 어시스턴트는 많은 일을 할 수 있지만 수동적인 고객센터 직원과 비슷합니다. 사용자가 묻지 않으면 먼저 말하지 않습니다. 일회성 문제를 처리할 때는 괜찮지만, 정기적으로 확인하거나 반복해서 실행해야 하는 작업에서는 꽤 번거롭습니다.

실제 사례를 하나 들어보겠습니다. 주식 투자를 하는 제 친구는 예전에 매일 몇 개의 주요 종목 가격을 직접 확인했습니다. 어느 날 회의 때문에 시세 확인을 잊어 중요한 매도 시점을 놓쳤고, 수만 위안을 손해 봤습니다. 나중에 그는 “AI가 먼저 알려 줬다면 좋았을 텐데”라고 불평했습니다.

문제의 핵심은 바로 이것입니다. 반복 작업은 시간을 낭비하게 만들고, 결정적인 순간에는 중요한 내용을 놓치기 쉽습니다.

제 경험도 하나 이야기해 보겠습니다. 저는 매일 아침 그날의 날씨, 일정, 주요 뉴스를 확인하는 습관이 있습니다. 예전에는 일반 AI 어시스턴트에게 아침마다 세 가지 질문을 직접 입력해야 했고, 타이핑에만 몇 분씩 들었습니다. 이제 OpenClaw 예약 작업을 설정해 둔 덕분에 매일 오전 7시면 이 정보가 Telegram으로 자동 전송됩니다. 양치하는 동안 모두 확인할 수 있습니다.

이것이 능동형 모드의 가치입니다. 반복 작업이 아니라 창의적인 일에 집중할 수 있도록 에너지를 되찾아 줍니다.

OpenClaw Cron Job의 핵심 개념

Linux를 사용해 봤다면 ‘Cron’이라는 단어가 익숙할 것입니다. 간단히 말해 Cron은 특정 프로그램을 지정한 시간에 자동 실행하도록 만드는 예약 작업 메커니즘입니다. 예를 들어 매일 새벽 2시에 데이터베이스를 자동 백업하거나 매주 월요일 오전 9시에 주간 보고서 알림을 보낼 수 있습니다.

OpenClaw의 Cron Job은 본질적으로 이 메커니즘을 AI 어시스턴트에 도입한 것이지만, 기존 Cron보다 훨씬 더 지능적입니다. 2026년 최신 기술 문서에 따르면 OpenClaw는 Gateway 스케줄러로 모든 cron 작업을 관리하며, 재시작 후에도 자동 복구해 작업이 계속 유지되도록 합니다.

두 가지 실행 모드: Main과 Isolated

OpenClaw는 두 가지 실행 모드를 제공합니다. 저도 처음에는 헷갈렸지만 사용하면서 차이를 이해하게 됐습니다.

1. Main Session 모드

이 모드는 예약 작업을 기본 대화에서 실행합니다. 평소 OpenClaw와 대화할 때처럼 이전 대화 기록을 확인하고 사용자의 선호와 배경 정보를 이해할 수 있다는 뜻입니다.

적합한 용도:

• 개인화된 콘텐츠가 필요한 작업(예: AI가 사용자가 관심을 갖는 뉴스를 아는 일일 브리핑)
• 컨텍스트가 필요한 작업(예: 어제 작성하던 문서 이어 쓰기)
• 전체 대화 기록을 활용해야 하는 복잡한 작업

2. Isolated Session 모드

이 모드는 예약 작업을 위한 독립 실행 공간(cron:<jobId>)을 만들며 기본 대화에는 영향을 주지 않습니다. 이 작업만 처리하는 별도 계정을 만든 것과 비슷합니다.

적합한 용도:

• 빈번한 모니터링 작업(예: 30분마다 주가 확인)
• 이전 대화가 필요 없는 작업(예: 날씨 조회)
• 기본 대화를 방해하지 않아야 하는 작업(예: 대량 로그 분석)

핵심 기능 한눈에 보기

OpenClaw Cron Job에는 제가 특히 마음에 든 기능이 몇 가지 있습니다.

표준 Cron 문법 지원
Linux Cron을 사용해 본 적이 있다면 이 문법도 익숙할 것입니다. 0 7 * * *은 매일 오전 7시, */30 * * * *은 30분마다 실행한다는 뜻입니다.

여러 채널로 전송
작업 실행 결과를 Telegram, WhatsApp, Slack으로 전송할 수 있습니다. 저는 휴대전화에서 실시간 알림을 확인할 수 있어 주로 Telegram을 사용합니다.

영구 저장
설정한 작업은 ~/.openclaw/cron/jobs.json 파일에 저장됩니다. OpenClaw Gateway가 재시작되더라도 작업은 사라지지 않습니다.

즉시 깨우기(Wake Now)
긴급한 작업이라 예정된 시간까지 기다리고 싶지 않다면 --now 매개변수로 즉시 실행할 수 있습니다. 테스트할 때 특히 유용합니다.

자동 정리
일회성 작업(예: 내일 오후 3시에 회의 알림)은 성공적으로 실행된 뒤 자동 삭제되므로 직접 정리할 필요가 없습니다.

BestEffort 전송 모드
매우 실용적인 기능입니다. 이 모드를 활성화하면 네트워크 문제 등으로 알림 전송에 실패하더라도 다음 작업 실행이 차단되지 않습니다.

첫 번째 Cron Job 설정하기

이제 이론은 충분히 살펴봤으니 실제로 설정해 보겠습니다. 가장 실용적인 사례인 매일 아침 브리핑을 구성해 보겠습니다.

시나리오 설정

평일마다 오전 7시에 AI가 다음 내용을 담은 브리핑을 자동으로 보내도록 하겠습니다.

1. 오늘의 일기예보
2. 캘린더의 중요 일정
3. 몇 가지 기술 뉴스
4. 동기 부여 문구 한 줄(이건 단순히 제 취향입니다)

설정 단계

1단계: 새 작업 추가

터미널을 열고 다음 명령을 실행합니다.

openclaw cron add --name "Morning Brief"

이 명령은 설정 파일에 새 작업 항목을 생성합니다.

2단계: 설정 파일 편집

nano ~/.openclaw/cron/jobs.json

nano가 익숙하지 않다면 vim이나 원하는 편집기를 사용해도 됩니다.

3단계: 설정 입력

열린 파일에서 방금 만든 작업을 찾아 다음과 같이 수정합니다.

{
  "name": "Morning Brief",
  "schedule": "0 7 * * 1-5",
  "skill": "daily-brief",
  "action": "main",
  "prompt": "오늘의 브리핑을 생성하세요. 1) 지역 일기예보 2) 내 캘린더 일정(Google Calendar에서 가져오기) 3) 기술 업계 주요 뉴스 3건 4) 오늘에 어울리는 동기 부여 문구 한 줄",
  "notify": {
    "channel": "telegram",
    "bestEffort": true
  }
}

설정 상세 설명

각 필드의 의미는 다음과 같습니다.

name: 작업 이름입니다. 알아보기 쉬운 이름을 자유롭게 지정하면 됩니다.

schedule: 예약 규칙입니다. 여기에서 0 7 * * 1-5는 다음을 의미합니다.

• 0 - 0분(정각)
• 7 - 오전 7시
• * - 매월 어느 날짜든 해당
• * - 어느 달이든 해당
• 1-5 - 월요일부터 금요일까지(주말 제외)

skill: 호출할 skill입니다. 사용자 정의 skill을 설정했다면 해당 이름을 입력하고, 없다면 prompt 필드에 지시문을 직접 작성해도 됩니다.

action: 실행 모드입니다. 여기서는 AI가 제가 사는 도시나 관심 기술 분야 같은 선호를 알기를 원하므로 main을 사용합니다.

prompt: 구체적인 작업 지시문입니다. 자세하게 작성할수록 AI가 더 정확하게 실행합니다.

notify: 알림 설정입니다.

• channel: 전송 채널이며 여기서는 Telegram을 사용합니다.
• bestEffort: 매우 중요합니다. true로 설정하면 네트워크 문제 등으로 전송에 실패해도 다음 작업의 실행을 막지 않습니다.

검증 테스트

설정을 마쳤다면 다음 날 오전 7시까지 기다리지 말고 먼저 테스트해 보세요.

설정된 작업 보기

openclaw cron list

방금 설정한 ‘Morning Brief’가 표시되어야 합니다.

즉시 테스트 실행

openclaw cron run "Morning Brief" --now

이 명령은 오전 7시까지 기다리지 않고 작업을 즉시 실행합니다. 설정이 올바르다면 곧 Telegram으로 메시지를 받을 수 있습니다.

실행 기록 보기

openclaw cron runs

이 명령은 성공 횟수와 실패 원인을 포함해 모든 작업의 실행 기록을 표시합니다. 작업이 예상대로 실행되지 않았다면 여기에서 단서를 찾을 수 있습니다.

실제 활용 사례

첫 작업을 설정하고 나면 “Cron Job으로 또 무엇을 할 수 있을까?”라는 생각이 들 수 있습니다. 활용 가능성은 매우 넓습니다. 제가 실제로 사용하는 사례 몇 가지를 소개하겠습니다.

사례 1: 주가 모니터링

앞서 소개한 주식 투자자 친구를 기억하시나요? 그가 현재 사용하는 설정은 다음과 같습니다.

{
  "name": "Stock Price Monitor",
  "schedule": "*/30 9-16 * * 1-5",
  "skill": "stock-monitor",
  "action": "isolated",
  "prompt": "다음 주식의 현재 가격을 확인하세요: AAPL, GOOGL, TSLA. 한 종목이라도 가격 변동이 3%를 넘으면 상세 정보를 즉시 전송하고, 그렇지 않으면 전송하지 마세요.",
  "notify": {
    "channel": "telegram",
    "condition": "price_alert_triggered"
  }
}

핵심 설명:

• */30 9-16 * * 1-5: 거래 시간(오전 9시부터 오후 4시까지)에 30분마다 확인
• action: "isolated": 30분마다 발생하는 확인 결과가 기본 대화를 어지럽히지 않도록 격리 모드 사용
• condition: 조건을 충족할 때만 전송해 불필요한 알림 방지

이 작업을 설정한 뒤로 그는 중요한 가격 변동을 놓치지 않게 됐습니다.

사례 2: 받은편지함 제로 관리

관리 업무를 하는 제 친구는 매일 수백 통의 이메일을 처리합니다. 그가 사용하는 설정은 다음과 같습니다.

{
  "name": "Email Inbox Monitor",
  "schedule": "0 */2 * * *",
  "skill": "inbox-zero",
  "action": "isolated",
  "prompt": "Gmail에 연결해 읽지 않은 메일을 확인하세요. 중요도에 따라 긴급(즉시 처리), 중요(오늘 처리), 일반(이번 주 처리)의 세 범주로 분류하고 긴급 메일의 답변 초안을 작성하세요.",
  "notify": {
    "channel": "slack",
    "bestEffort": true
  }
}

핵심 내용:

• 0 */2 * * *: 2시간마다 확인
• 팀이 협업하기 쉽도록 Slack 업무 채널로 전송
• AI가 자동으로 분류하고 답변 초안을 작성해 효율을 크게 높임

사례 3: 스마트 홈 야간 점검

스마트 홈 기기를 사용한다면 다음 사례가 유용할 수 있습니다.

{
  "name": "Smart Home Night Check",
  "schedule": "0 23 * * *",
  "skill": "home-security",
  "action": "main",
  "prompt": "야간 보안 점검을 실행하세요. 1) 모든 문과 창문 센서 상태 확인 2) 보안 시스템 활성화 여부 확인 3) 실내 온도가 18~24도인지 확인 4) 야간등을 제외한 모든 조명이 꺼졌는지 확인. 이상이 있으면 즉시 알리세요.",
  "notify": {
    "channel": "whatsapp"
  }
}

매일 오후 11시에 자동 점검하고 문제가 발견되면 즉시 WhatsApp으로 알립니다. 저는 반년 동안 사용하면서 문이 제대로 잠기지 않은 상황을 두 번이나 발견했습니다.

사례 4: GitHub 저장소 모니터링

프로그래머라면 다음 설정이 필요할 수 있습니다.

{
  "name": "GitHub Repo Monitor",
  "schedule": "0 10 * * *",
  "skill": "github-monitor",
  "action": "isolated",
  "prompt": "내 GitHub 저장소(repo1, repo2, repo3)를 확인하세요. 1) 새 Issues 2) 새 Pull Requests 3) Star 수 변화를 확인하고 일일 요약 보고서를 생성하세요.",
  "notify": {
    "channel": "telegram",
    "bestEffort": true
  }
}

매일 오전 10시에 GitHub 활동 요약을 받아볼 수 있어 페이지를 직접 새로 고칠 필요가 없습니다.

고급 팁과 모범 사례

OpenClaw Cron Job을 한동안 사용하며 정리한 경험을 공유하겠습니다.

모범 사례 체크리스트

1. 소음이 많은 작업 격리
10분마다 확인하는 작업처럼 빈번한 모니터링에는 반드시 isolated 모드를 사용해야 합니다. 그렇지 않으면 기본 대화가 결과로 도배됩니다. 저도 처음에는 5분마다 실행하는 작업을 main 모드로 설정하는 실수를 했고, 기본 대화가 모니터링 로그로 가득 차 정상적인 대화를 할 수 없었습니다.

2. 중요한 작업에는 wake 모드 사용
시간에 매우 민감한 작업이라면 설정에 "wake": "now"를 추가하세요. 다음 heartbeat 주기를 기다리지 않고 정확한 시점에 작업이 실행됩니다.

3. 특정 Agent 연결
이메일 전용 Agent처럼 여러 전문 Agent를 설정했다면 agentId 필드로 작업을 실행할 Agent를 지정할 수 있습니다.

{
  "agentId": "email-specialist",
  "name": "Email Monitor",
  ...
}

4. 알림을 합리적으로 설정
모든 작업에 알림이 필요한 것은 아닙니다. 예를 들어 매시간 메모를 백업하는 작업은 알림 없이 로그만 기록하면 됩니다. 중요하지 않은 작업에는 bestEffort: true를 설정해 간헐적인 전송 실패가 전체 작업 체인에 영향을 주지 않도록 하는 것이 좋습니다.

5. heartbeat 확인과 결합
OpenClaw에는 특정 조건을 주기적으로 확인하는 heartbeat 메커니즘이 있습니다. Cron Job과 heartbeat를 결합하면 더 지능적인 조건부 트리거를 구현할 수 있습니다.

Cron 문법 빠른 참조표

솔직히 Cron 문법은 처음에는 외우기 번거롭습니다. 자주 쓰는 표현을 정리하면 다음과 같습니다.

# 1분마다 실행
* * * * *

# 매일 오전 9시
0 9 * * *

# 평일 오후 5시(월요일~금요일)
0 17 * * 1-5

# 매주 일요일 오후 8시
0 20 * * 0

# 15분마다 실행
*/15 * * * *

# 매시간 30분
30 * * * *

# 매월 1일 오전 2시
0 2 1 * *

# 매년 1월 1일 자정
0 0 1 1 *

# 매일 오전 10시부터 오후 6시까지 1시간마다 실행
0 10-18 * * *

형식은 분 시 일 월 요일입니다.

여전히 어렵게 느껴진다면 온라인 도구 Crontab Guru를 사용해 보세요. 원하는 시간을 입력하면 문법을 자동으로 생성합니다.

디버깅 팁

작업이 실행되지 않거나 결과가 예상과 다를 때는 어떻게 조사해야 할까요? 제 경험으로는 다음 방법이 유용합니다.

로그 실시간 모니터링

tail -f ~/.openclaw/logs/cron.log

이 명령은 Cron 작업의 실행 로그를 실시간으로 보여 줍니다. 각 작업의 트리거 시간, 실행 결과, 오류 정보를 확인할 수 있습니다.

작업 상태 확인

openclaw cron status "Morning Brief"

특정 작업의 마지막 실행 시간, 다음 예정 시간, 성공률 등 상세 상태를 확인합니다.

직접 실행하며 디버그 활성화

openclaw cron run "Morning Brief" --now --debug

--debug 매개변수는 상세한 실행 과정을 출력하므로 AI의 추론 단계와 API 호출 상태를 확인할 수 있습니다.

Cron 문법 검증
시간 설정에 문제가 있다고 의심되면 crontab.guru 같은 온라인 도구로 문법을 검증할 수 있습니다.

보안 권장 사항

OpenClaw 예약 작업은 민감한 작업을 다룰 수 있으므로 다음 보안 사항을 지키는 것이 좋습니다.

1. 자격 증명을 평문으로 저장하지 않기
작업에서 Gmail이나 주식 API 같은 외부 서비스에 접근해야 한다면 API 키를 설정 파일에 직접 작성하지 마세요. 환경 변수를 사용하는 것이 좋습니다.

{
  "prompt": "환경 변수 $GMAIL_API_KEY를 사용해 Gmail에 연결하세요..."
}

2. 실행 로그 정기 검토
정기적으로 ~/.openclaw/logs/ 디렉터리를 확인해 비정상적인 실행 기록이 없는지 살펴보세요. 저는 매주 금요일에 5분 정도 확인합니다.

3. 실패 알림 설정
중요한 작업에는 실패 알림을 설정하는 것이 좋습니다.

{
  "notify": {
    "onFailure": true,
    "channel": "telegram"
  }
}

이렇게 하면 작업 실행에 실패했을 때 즉시 알 수 있습니다.

4. 최소 권한 적용
작업에 읽기 권한만 필요하다면 쓰기 권한을 부여하지 마세요. OpenClaw는 세분화된 권한 제어를 지원하므로 적극 활용하는 것이 좋습니다.

마치며

솔직히 OpenClaw Cron Job을 설정한 뒤 AI 어시스턴트를 사용하는 방식이 완전히 달라졌습니다. 예전에는 AI를 필요할 때만 호출하는 ‘수동 도구’로 여겼지만, 이제는 언제 무엇을 해야 할지 스스로 판단하는 ‘능동적인 동료’에 가깝습니다.

수동 응답에서 능동 실행으로의 전환은 단순한 기술 기능 이상의 의미를 갖습니다. AI 어시스턴트의 역할 자체가 진화하는 것입니다. 더 이상 매일 AI에 무엇을 물어봐야 할지 기억하거나 중요한 점검을 놓칠까 걱정할 필요가 없습니다. AI가 적절한 시간에 필요한 작업을 먼저 처리합니다.

아직 OpenClaw의 Cron Job을 사용해 보지 않았다면 매일 아침 브리핑처럼 간단한 사례부터 시작해 보세요. 설정은 5분도 걸리지 않지만 효율 향상은 오랫동안 이어집니다.

저는 현재 업무, 생활, 투자에 걸쳐 약 열몇 개의 예약 작업을 설정해 사용합니다. 아침에 눈을 뜨면 중요한 정보가 이미 정리되어 휴대전화로 도착해 있고, 업무 중에는 이메일과 메시지를 확인하려고 창을 자주 전환할 필요가 없습니다. 잠들기 전 집 안의 보안 점검도 자동으로 끝납니다. AI가 명령을 기다리는 것이 아니라 반복적이지만 꼭 필요한 일을 먼저 처리해 주는 경험은 꽤 만족스럽습니다.

설정 과정에서 문제가 생긴다면 OpenClaw 공식 문서를 확인하거나 커뮤니티에 질문해 보세요. 많은 사용자가 자신의 설정 경험과 활용 방법을 기꺼이 공유합니다.

지금 첫 번째 예약 작업을 설정해 보세요. 내일부터는 AI가 먼저 일하게 만들 수 있습니다.

---

참고 자료:

• OpenClaw 공식 문서
• Cron 문법 생성기
• OpenClaw GitHub Discussions(커뮤니티 대화는 저장소의 Discussions를 기준으로 합니다.)
• OpenClaw Telegram 연동 가이드