메인 콘텐츠로 건너뛰기

​
Task Flow

Task Flow는 백그라운드 작업 위에 위치하는 흐름 오케스트레이션 기반 계층입니다. 개별 작업은 분리된 작업의 단위로 유지되는 반면, 자체 상태, 리비전 추적, 동기화 의미 체계를 갖춘 내구성 있는 다단계 흐름을 관리합니다.

​
Task Flow를 사용해야 하는 경우

작업이 여러 순차적 단계 또는 분기 단계에 걸쳐 있고 게이트웨이 재시작 전반에 걸쳐 내구성 있는 진행 상황 추적이 필요하다면 Task Flow를 사용하세요. 단일 백그라운드 작업의 경우 일반 작업이면 충분합니다.
시나리오사용 방식
단일 백그라운드 작업일반 작업
다단계 파이프라인 (A 다음 B 다음 C)Task Flow (관리형)
외부에서 생성된 작업 관찰Task Flow (미러링)
일회성 리마인더cron 작업

​
동기화 모드

​
관리형 모드

Task Flow는 수명 주기를 처음부터 끝까지 소유합니다. 흐름 단계로 작업을 생성하고, 완료될 때까지 구동하며, 흐름 상태를 자동으로 진행시킵니다. 예: 주간 보고서 흐름이 (1) 데이터를 수집하고, (2) 보고서를 생성하고, (3) 전달합니다. Task Flow는 각 단계를 백그라운드 작업으로 생성하고, 완료를 기다린 다음, 다음 단계로 이동합니다. 
Flow: weekly-report
  Step 1: gather-data     → task created → succeeded
  Step 2: generate-report → task created → succeeded
  Step 3: deliver         → task created → running

​
미러링 모드

Task Flow는 외부에서 생성된 작업을 관찰하고 작업 생성에 대한 소유권을 갖지 않으면서 흐름 상태를 동기화된 상태로 유지합니다. 이는 작업이 cron 작업, CLI 명령 또는 기타 소스에서 시작되고, 이를 흐름으로서 진행 상황을 통합된 보기로 확인하고 싶을 때 유용합니다. 예: 함께 “아침 운영” 루틴을 구성하는 세 개의 독립적인 cron 작업. 미러링된 흐름은 작업의 실행 시점이나 실행 방식을 제어하지 않고도 이들의 전체 진행 상황을 추적합니다.

​
내구성 있는 상태 및 리비전 추적

각 흐름은 자체 상태를 유지하고 리비전을 추적하므로 게이트웨이가 재시작되어도 진행 상황이 유지됩니다. 리비전 추적은 여러 소스가 동시에 동일한 흐름을 진행시키려 할 때 충돌 감지를 가능하게 합니다.

​
취소 동작

openclaw tasks flow cancel은 흐름에 고정 취소 의도를 설정합니다. 흐름 내의 활성 작업은 취소되며 새 단계는 시작되지 않습니다. 취소 의도는 재시작 후에도 유지되므로, 모든 하위 작업이 종료되기 전에 게이트웨이가 재시작되더라도 취소된 흐름은 계속 취소된 상태로 유지됩니다.

​
CLI 명령

# 활성 및 최근 흐름 나열
openclaw tasks flow list

# 특정 흐름의 세부 정보 표시
openclaw tasks flow show <lookup>

# 실행 중인 흐름과 그 활성 작업 취소
openclaw tasks flow cancel <lookup>
명령설명
openclaw tasks flow list상태 및 동기화 모드와 함께 추적된 흐름 표시
openclaw tasks flow show <id>흐름 id 또는 조회 키로 하나의 흐름 검사
openclaw tasks flow cancel <id>실행 중인 흐름과 그 활성 작업 취소

​
흐름과 작업의 관계

흐름은 작업을 조정하는 것이지, 작업을 대체하는 것이 아닙니다. 하나의 흐름은 수명 주기 동안 여러 백그라운드 작업을 구동할 수 있습니다. 개별 작업 레코드를 검사하려면 openclaw tasks를 사용하고, 오케스트레이션하는 흐름을 검사하려면 openclaw tasks flow를 사용하세요.

​
관련 항목