Task Flow·Hooks·Standing Orders
기준일: 2026-07-26
난이도: 중급
공식 기준: Automation, Task Flow, Background tasks, Hooks, Standing orders, Tasks CLI
OpenClaw 자동화는 cron만이 아닙니다. 장기 작업 상태, 이벤트 반응, 상시 운영 권한을 분리해서 다뤄야 합니다. 레거시 openclaw flows 네임스페이스는 openclaw tasks flow 로 리다이렉트됩니다.
핵심 개념
| 기능 | 역할 | 관리 표면 |
|---|---|---|
| background tasks | ACP run, subagent, isolated cron, CLI 등 detached work 원장 | openclaw tasks list, audit, show, cancel |
| cron jobs | 정해진 시각/간격의 반복·one-shot 작업 | openclaw cron ... |
| hooks | 명령·세션·lifecycle 이벤트 반응 스크립트 | openclaw hooks ... |
| plugin hooks | tool call 등 in-process 가로채기 | Plugin hooks |
| standing orders | 에이전트가 지속적으로 따를 운영 권한·경계 | workspace AGENTS.md 등 (세션마다 주입) |
| Task Flow | background task 위의 multi-step orchestration | openclaw tasks flow list|show|cancel |
Cron 실행은 task record를 만듭니다. Heartbeat main-session turn은 task record를 만들지 않습니다. 자세한 선택표는 자동화 개요를 보세요.
Standing orders
Standing orders는 영구 운영 권한을 프로그램 단위로 정의합니다. 매 작업마다 프롬프트하지 않고, scope·trigger·approval gate·escalation을 문서로 고정합니다.
권장 위치:
AGENTS.md— 세션 bootstrap에 자동 주입되므로 가장 확실합니다.- 큰 설정은
standing-orders.md등으로 분리한 뒤AGENTS.md에서 참조합니다.
(bootstrap은AGENTS.md,SOUL.md,TOOLS.md등 지정 파일만 자동 주입합니다. 임의 하위 경로 파일은 참조 없이는 안 들어갑니다.)
프로그램 골격 예시:
## Program: Weekly Status Report
**Authority:** 데이터 수집, 리포트 작성, 이해관계자 전달
**Trigger:** 매주 금요일 16:00 (cron으로 강제)
**Approval gate:** 표준 리포트는 없음. 이상치만 사람 검토
**Escalation:** 데이터 소스 불가, 지표가 평소 대비 크게 벗어날 때
### What NOT to do
- 외부 제3자에게 발송 금지
- 원본 데이터 수정 금지
Standing order는 무엇을 해도 되는지 정의하고, cron은 언제 실행할지 정의합니다. cron 메시지에는 절차를 복붙하지 말고 standing order를 참조하세요.
openclaw cron add \
--name daily-inbox-triage \
--cron "0 8 * * 1-5" \
--message "Execute daily inbox triage per standing orders. Report summary. Escalate unknowns."
모범 패턴: Execute → Verify → Report. “할게요”만 남기고 끝내지 않도록 문서에 명시합니다. 권한은 좁게 시작해 신뢰를 쌓은 뒤 넓힙니다.
Task Flow
Task Flow는 개별 task 위의 durable multi-step 흐름입니다. revision 추적, managed/mirrored sync 모드, 취소·조회 CLI를 제공합니다. 단순 리마인더에는 cron이 충분하고, 연구→요약→전달처럼 단계가 길면 Task Flow를 검토합니다.
openclaw tasks list
openclaw tasks audit
openclaw tasks show <id>
openclaw tasks flow list
openclaw tasks flow show <id>
openclaw tasks flow cancel <id>
Control UI(v2026.7.1+)의 live Tasks 페이지에서도 활성·최근 background work를 보고 취소할 수 있습니다.
Hooks
- Internal hooks:
/new,/reset,/stop, compaction, gateway startup, message flow 등 lifecycle. 훅 디렉터리에서 발견되고openclaw hooks로 관리. - Plugin hooks: tool call·prompt·message를 프로세스 안에서 가로챕니다.
openclaw hooks list
openclaw hooks info <name>
openclaw hooks check
openclaw hooks enable <name>
openclaw hooks disable <name>
민감한 데이터를 외부로 보내는 훅은 보안 검토 없이 켜지 마세요.
선택 기준
| 상황 | 추천 |
|---|---|
| 매일 같은 시각 보고서 | Cron |
| 여러 단계 + 상태 조회/취소 | Task Flow |
| subagent/ACP 실행 추적 | Background Tasks (tasks list) |
| 세션 reset·startup 반응 | Hooks |
| 항상 적용되는 운영 원칙 | Standing Orders (+ 필요 시 cron 강제) |
| 도구 호출 가로채기·정책 | Plugin hooks / policy |
실습
openclaw tasks list
openclaw tasks flow list
openclaw cron list
openclaw hooks list
openclaw system heartbeat last
자동화 후보 분류:
다음 OpenClaw 자동화 후보를 cron, heartbeat, hook, Task Flow, standing order로 분류해줘.
각 후보에 필요한 승인, 로그, 실패 복구, 취소 명령을 함께 제안해줘.
도구에 입력할 프롬프트
OpenClaw에서 이 자동화를 만들기 전에 위험 분석을 해줘.
권한 범위(standing order scope), 재시도, 사람이 개입해야 하는 지점,
취소 명령(tasks flow cancel / cron disable), 로그 확인 명령을 포함해줘.
체크리스트
- cron과 Task Flow·Heartbeat의 차이를 구분했다.
- detached work는
openclaw tasks로 추적한다. - 레거시
flows대신tasks flow를 쓴다. - standing order는
AGENTS.md(또는 참조 구조)에 두고 권한을 좁게 유지한다. - hooks가 민감한 정보를 외부로 보내지 않는지 확인했다.
- 실패 시
tasks,logs,gateway health로 추적할 수 있다.
다음 단계
- Cron 가이드에서 정기 작업을 만듭니다.
- 자동화 개요에서 전체 결정표를 봅니다.
- Gateway 운영에서 장기 작업 로그를 확인합니다.
- CLI 명령어에서
tasks·hooks표면을 확인합니다.