자동화 개요

OpenClaw의 자동화 기능을 사용하여 반복 작업을 자동화하세요.

개요

자동화를 사용하면 다음과 같은 작업을 자동화할 수 있습니다:

• Heartbeat: 주기적 작업 실행
• Cron Jobs: 예약된 작업 관리
• 트리거: 이벤트 기반 실행
• 유스케이스: 실전 활용 사례

자동화 구성 요소

빠른 시작

Heartbeat 설정

{
  "automation": {
    "heartbeat": {
      "enabled": true,
      "jobs": [
        {
          "id": "status-check",
          "interval": 600,
          "agentId": "health-check"
        }
      ]
    }
  }
}

Cron Job 설정

{
  "automation": {
    "cron": {
      "enabled": true,
      "jobs": [
        {
          "id": "morning-report",
          "schedule": "0 9 * * *",
          "agentId": "report-agent"
        }
      ]
    }
  }
}

주요 기능

Heartbeat

규칙적인 간격으로 작업을 실행합니다:

• 간격 설정: 초 단위 (예: 600초 = 10분)
• 유연한 스케줄링: 고정된 간격으로 반복
• 상태 모니터링: 정기적 헬스 체크

사용 예시:

• API 상태 확인
• 데이터베이스 백업
• 리소스 모니터링

Cron

Unix cron 표현식을 사용한 복잡한 스케줄링:

• 유연한 표현식: 분, 시, 일, 월, 요일
• 복잡한 스케줄: 평일 아침, 월간 리포트 등
• 표준 호환: 기존 cron 지식 활용

사용 예시:

• 매일 아침 리포트
• 주간 정리
• 월간 청구

일반적인 사용 사례

1. 정기적 상태 확인

{
  "automation": {
    "heartbeat": {
      "enabled": true,
      "jobs": [
        {
          "id": "health-check",
          "interval": 300,
          "agentId": "health-agent"
        }
      ]
    }
  }
}

2. 매일 아침 리포트

{
  "automation": {
    "cron": {
      "enabled": true,
      "jobs": [
        {
          "id": "daily-summary",
          "schedule": "0 9 * * *",
          "agentId": "summary-agent",
          "channel": "slack"
        }
      ]
    }
  }
}

3. 주간 정리

{
  "automation": {
    "cron": {
      "enabled": true,
      "jobs": [
        {
          "id": "weekly-cleanup",
          "schedule": "0 18 * * 5",
          "agentId": "cleanup-agent"
        }
      ]
    }
  }
}

트러블슈팅

자동화가 실행되지 않음

확인사항:

1. automation.enabled가 true인지 확인
2. 각 기능의 enabled가 true인지 확인
3. 에이전트 ID가 올바른지 확인

# 자동화 상태 확인
openclaw automation status

# 자동화 로그 확인
openclaw logs --filter automation

Cron 표현식이 작동하지 않음

• 온라인 cron 표현식 테스터 사용
• 타임존 설정 확인

참고:

• 공식 문서: Automation