CLI commands
`openclaw tasks`
지속성 있는 백그라운드 작업과 Task Flow 상태를 검사합니다. 하위 명령이 없으면
openclaw tasks는 openclaw tasks list와 동일합니다.
수명 주기 및 전달 모델은 백그라운드 작업을 참조하고,
전체 검사 결과 설명은 해당 문서의 tasks audit 섹션을 참조하세요.
사용법
openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw tasks flow show <lookup>openclaw tasks flow cancel <lookup>루트 옵션
| 플래그 | 설명 |
|---|---|
--json |
JSON을 출력합니다. |
--runtime <name> |
종류별로 필터링합니다: subagent, acp, cron 또는 cli. |
--status <name> |
상태별로 필터링합니다: queued, running, succeeded, failed, timed_out, cancelled 또는 lost. |
하위 명령
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]추적된 백그라운드 작업을 최신순으로 나열합니다.
show
openclaw tasks show <lookup> [--json]작업 ID, 실행 ID 또는 세션 키로 작업 하나를 표시합니다.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>실행 중인 작업의 알림 정책을 변경합니다.
cancel
openclaw tasks cancel <lookup>실행 중인 백그라운드 작업을 취소합니다.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]오래되었거나, 유실되었거나, 전달에 실패했거나, 그 밖에 일관성이 없는 작업 및
Task Flow 레코드를 표시합니다. cleanupAfter까지 유지되는 유실 작업은 경고이며,
만료되었거나 정리 시점이 기록되지 않은 유실 작업은 오류입니다.
--code는 작업 코드(stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps)와 Task
Flow 코드(restore_failed, stale_waiting, stale_blocked,
cancel_stuck, missing_linked_tasks, blocked_task_missing)를 허용합니다. 코드별
심각도와 트리거에 대한 자세한 내용은 백그라운드 작업을
참조하세요.
maintenance
openclaw tasks maintenance [--apply] [--json]작업 및 Task Flow 조정, 정리 시점 기록, 가지치기, 오래된 Cron 실행 세션 레지스트리 정리를 미리 보거나 적용합니다.
Cron 작업의 경우 조정 시 이전 활성 작업을 lost로 표시하기 전에 저장된 실행
로그/작업 상태를 사용하므로, 인메모리 Gateway 런타임 상태가 사라졌다는 이유만으로
완료된 Cron 실행이 잘못된 검사 오류가 되지 않습니다. 오프라인 CLI 검사는
Gateway의 프로세스 로컬 Cron 활성 작업 집합에 대한 권위 있는 정보가 아닙니다.
실행 ID/소스 ID가 있는 CLI 작업은 이전 하위 세션 행이 남아 있더라도 실시간
Gateway 실행 컨텍스트가 사라지면 lost로 표시됩니다.
적용하면 유지 관리는 현재 실행 중인 Cron 작업을 보존하고 Cron이 아닌 세션 행은
변경하지 않은 채, 7일보다 오래된 cron:<jobId>:run:<uuid> 세션 레지스트리 행도
가지치기합니다.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>작업 원장의 지속성 있는 Task Flow 상태를 검사하거나 취소합니다.
flow list --status는 queued, running, waiting, blocked,
succeeded, failed, cancelled 또는 lost를 허용합니다.
