Automation
상시 지시 사항
상시 지시는 정의된 프로그램에 대해 에이전트에 영구적인 운영 권한을 부여합니다. 각 작업마다 에이전트에 요청하는 대신 명확한 범위, 트리거, 에스컬레이션 규칙을 갖춘 프로그램을 정의하면 에이전트가 해당 경계 내에서 자율적으로 실행합니다. "주간 보고서는 네가 담당한다. 매주 금요일에 작성하여 전송하고, 문제가 있어 보일 때만 에스컬레이션하라."
상시 지시가 필요한 이유
상시 지시가 없는 경우: 모든 작업을 에이전트에 일일이 요청해야 하고, 일상 업무가 누락되거나 지연되며, 사용자가 병목 지점이 됩니다.
상시 지시가 있는 경우: 에이전트가 정의된 경계 내에서 자율적으로 실행하고, 일상 업무가 일정에 따라 처리되며, 사용자는 예외 상황과 승인에만 관여합니다.
작동 방식
상시 지시는 에이전트 작업 공간 파일에 정의됩니다. 권장 방식은 에이전트가 항상 해당 지시를 컨텍스트에 포함하도록 매 세션에 자동으로 주입되는 AGENTS.md에 직접 작성하는 것입니다. 구성이 큰 경우 standing-orders.md 같은 전용 파일에 작성하고 AGENTS.md에서 참조할 수도 있습니다.
각 프로그램은 다음을 지정합니다.
- 범위 - 에이전트가 수행하도록 허가된 작업
- 트리거 - 실행 시점(일정, 이벤트 또는 조건)
- 승인 관문 - 실행 전에 사람의 승인이 필요한 작업
- 에스컬레이션 규칙 - 중단하고 도움을 요청해야 하는 시점
에이전트는 작업 공간 부트스트랩 파일을 통해 매 세션마다 이러한 지시를 불러오며(자동 주입되는 파일의 전체 목록은 에이전트 작업 공간 참조), 시간 기반 실행을 위한 Cron 작업과 결합하여 지시에 따라 작업을 수행합니다.
상시 지시의 구성
## 프로그램: 주간 상태 보고서 **권한:** 데이터 취합, 보고서 생성, 이해관계자에게 전달**트리거:** 매주 금요일 오후 4시(Cron 작업으로 실행)**승인 관문:** 표준 보고서에는 없음. 이상 징후는 사람의 검토 대상으로 표시.**에스컬레이션:** 데이터 소스를 사용할 수 없거나 지표가 비정상적으로 보이는 경우(정상 범위에서 >2σ) ### 실행 단계 1. 구성된 소스에서 지표 가져오기2. 이전 주 및 목표와 비교3. Reports/weekly/YYYY-MM-DD.md에 보고서 생성4. 구성된 채널을 통해 요약 전달5. Agent/Logs/에 완료 기록 ### 하지 말아야 할 작업 - 외부 관계자에게 보고서를 보내지 않기- 원본 데이터를 수정하지 않기- 지표가 좋지 않아 보여도 전달을 생략하지 말고 정확하게 보고하기상시 지시와 Cron 작업
상시 지시는 에이전트가 무엇을 수행하도록 허가되었는지 정의합니다. Cron 작업은 해당 작업이 언제 실행되는지 정의합니다. 두 기능은 다음과 같이 함께 작동합니다.
상시 지시: "일일 받은편지함 분류를 네가 담당한다" ↓Cron 작업(매일 오전 8시): "상시 지시에 따라 받은편지함 분류 실행" ↓에이전트: 상시 지시 읽기 → 단계 실행 → 결과 보고Cron 작업 프롬프트는 상시 지시를 중복해서 작성하지 말고 참조해야 합니다.
openclaw cron add \ --name daily-inbox-triage \ --cron "0 8 * * 1-5" \ --tz America/New_York \ --timeout-seconds 300 \ --announce \ --channel imessage \ --to "+1XXXXXXXXXX" \ --message "상시 지시에 따라 일일 받은편지함 분류를 실행하세요. 새 알림이 있는지 메일을 확인하세요. 각 항목을 파싱하고 분류하여 저장하세요. 소유자에게 요약을 보고하세요. 알 수 없는 항목은 에스컬레이션하세요."예시
예시 1: 콘텐츠 및 소셜 미디어(주간 주기)
## 프로그램: 콘텐츠 및 소셜 미디어 **권한:** 콘텐츠 초안 작성, 게시물 예약, 참여도 보고서 작성**승인 관문:** 처음 30일 동안은 모든 게시물에 소유자 검토가 필요하며, 이후에는 상시 승인 적용**트리거:** 주간 주기(월요일 검토 → 주중 초안 작성 → 금요일 브리핑) ### 주간 주기 - **월요일:** 플랫폼 지표 및 잠재고객 참여도 검토- **화요일~목요일:** 소셜 게시물 초안 및 블로그 콘텐츠 작성- **금요일:** 주간 마케팅 브리핑 작성 → 소유자에게 전달 ### 콘텐츠 규칙 - 문체는 브랜드와 일치해야 함(SOUL.md 또는 브랜드 문체 가이드 참조)- 공개 콘텐츠에서 자신을 AI라고 밝히지 않기- 가능한 경우 지표 포함- 자기 홍보가 아니라 잠재고객에게 제공하는 가치에 집중예시 2: 재무 운영(이벤트 기반)
## 프로그램: 재무 처리 **권한:** 거래 데이터 처리, 보고서 생성, 요약 전송**승인 관문:** 분석에는 없음. 권고 사항에는 소유자 승인이 필요함.**트리거:** 새 데이터 파일 감지 또는 예약된 월간 주기 ### 새 데이터가 도착한 경우 1. 지정된 입력 디렉터리에서 새 파일 감지2. 모든 거래를 파싱하고 분류3. 예산 목표와 비교4. 비정상 항목, 임계값 초과, 새로운 반복 청구를 표시5. 지정된 출력 디렉터리에 보고서 생성6. 구성된 채널을 통해 소유자에게 요약 전달 ### 에스컬레이션 규칙 - 단일 항목 > $500: 즉시 알림- 범주가 예산보다 20% 초과: 보고서에 표시- 식별할 수 없는 거래: 소유자에게 분류 요청- 두 번 재시도한 후에도 처리 실패: 실패를 보고하고 추측하지 않기예시 3: 모니터링 및 알림(지속 실행)
## 프로그램: 시스템 모니터링 **권한:** 시스템 상태 확인, 서비스 재시작, 알림 전송**승인 관문:** 서비스를 자동으로 재시작. 재시작이 두 번 실패하면 에스컬레이션.**트리거:** 매 Heartbeat 주기 ### 확인 항목 - 서비스 상태 엔드포인트 응답 여부- 디스크 여유 공간이 임계값 이상인지 여부- 대기 중인 작업이 오래 방치되지 않았는지 여부(>24시간)- 전달 채널의 정상 작동 여부 ### 대응 매트릭스 | 조건 | 조치 | 에스컬레이션 여부 || -------------------- | ----------------------------- | ------------------------------ || 서비스 중단 | 자동으로 재시작 | 재시작이 2회 실패한 경우에만 || 디스크 여유 공간 < 10% | 소유자에게 알림 | 예 || 방치된 작업 > 24시간 | 소유자에게 알림 | 아니요 || 채널 오프라인 | 기록하고 다음 주기에 재시도 | 2시간 넘게 오프라인인 경우 |실행-검증-보고 패턴
상시 지시는 엄격한 실행 규율과 결합할 때 가장 효과적입니다. 상시 지시의 모든 작업은 다음 반복 절차를 따라야 합니다.
- 실행 - 실제 작업 수행(지시를 확인했다는 응답만 하지 않기)
- 검증 - 결과가 올바른지 확인(파일 존재, 메시지 전달, 데이터 파싱)
- 보고 - 수행한 작업과 검증한 내용을 소유자에게 알리기
### 실행 규칙 - 모든 작업은 실행-검증-보고를 따릅니다. 예외는 없습니다.- "그렇게 하겠습니다"는 실행이 아닙니다. 실행한 다음 보고하세요.- 검증 없이 "완료"라고 하는 것은 허용되지 않습니다. 증명하세요.- 실행에 실패하면 접근 방식을 조정하여 한 번 재시도합니다.- 여전히 실패하면 진단 내용과 함께 실패를 보고합니다. 절대로 아무런 보고 없이 실패하지 마세요.- 무기한 재시도하지 마세요. 최대 3번 시도한 후 에스컬레이션하세요.이 패턴은 작업을 완료하지 않고 확인 응답만 하는 가장 흔한 에이전트 실패 유형을 방지합니다.
다중 프로그램 아키텍처
여러 영역을 관리하는 에이전트의 경우 상시 지시를 경계가 명확한 별도의 프로그램으로 구성하세요.
## 프로그램 1: [영역 A] (주간) ... ## 프로그램 2: [영역 B] (월간 + 요청 시) ... ## 프로그램 3: [영역 C] (필요 시) ... ## 에스컬레이션 규칙 (모든 프로그램) - [공통 에스컬레이션 기준]- [프로그램 전반에 적용되는 승인 관문]각 프로그램에는 다음 항목이 있어야 합니다.
- 자체적인 트리거 주기(주간, 월간, 이벤트 기반, 지속 실행)
- 자체적인 승인 관문(일부 프로그램에는 다른 프로그램보다 더 많은 감독이 필요함)
- 명확한 경계(에이전트가 한 프로그램이 끝나고 다른 프로그램이 시작되는 지점을 알아야 함)
모범 사례
권장 사항
- 좁은 권한으로 시작하고 신뢰가 쌓임에 따라 확대
- 위험도가 높은 작업에 명시적인 승인 관문 정의
- "하지 말아야 할 작업" 섹션 포함 - 권한만큼 경계도 중요함
- 신뢰할 수 있는 시간 기반 실행을 위해 Cron 작업과 결합
- 에이전트 로그를 매주 검토하여 상시 지시 준수 여부 확인
- 요구 사항의 변화에 따라 상시 지시 업데이트 - 상시 지시는 지속적으로 관리하는 문서임
피해야 할 사항
- 첫날부터 광범위한 권한 부여("최선이라고 생각하는 것은 무엇이든 수행")
- 에스컬레이션 규칙 생략 - 모든 프로그램에는 "중단하고 질문해야 하는 시점" 조항이 필요함
- 에이전트가 구두 지시를 기억할 것이라고 가정 - 모든 내용을 파일에 작성
- 단일 프로그램에 여러 영역을 혼합 - 영역별로 프로그램 분리
- Cron 작업을 통한 실행 강제를 잊는 것 - 트리거가 없는 상시 지시는 제안에 불과함
관련 문서
- 자동화: 모든 자동화 메커니즘을 한눈에 확인합니다.
- Cron 작업: 상시 지시의 일정 실행을 강제합니다.
- 훅: 에이전트 수명 주기 이벤트를 위한 이벤트 기반 스크립트입니다.
- Webhook: 인바운드 HTTP 이벤트 트리거입니다.
- 에이전트 작업 공간: 자동 주입되는 부트스트랩 파일(
AGENTS.md,SOUL.md등)의 전체 목록을 포함하여 상시 지시가 저장되는 위치를 설명합니다.