태스크 플로우
태스크 플로우는 백그라운드 태스크 위에 위치하는 플로우 조율 기반입니다. 관리형 및 미러링 동기화 모드, 개정 추적, openclaw tasks flow list|show|cancel을 통한 검사 기능을 갖춘 내구성 있는 다단계 플로우를 관리합니다.
태스크 플로우를 사용하는 시점
작업이 여러 순차적 또는 분기 단계에 걸쳐 있고 게이트웨이 재시작 후에도 내구성 있는 진행 추적이 필요할 때 태스크 플로우를 사용하십시오. 단일 백그라운드 작업에는 일반 태스크로 충분합니다.
| 시나리오 | 사용 |
|---|---|
| 단일 백그라운드 작업 | 일반 태스크 |
| 다단계 파이프라인 (A 후 B 후 C) | 태스크 플로우 (관리형) |
| 외부 생성 태스크 관찰 | 태스크 플로우 (미러링) |
| 일회성 알림 | 크론 작업 |
동기화 모드
관리형 모드
태스크 플로우가 엔드투엔드 수명 주기를 소유합니다. 태스크를 플로우 단계로 생성하고, 완료 시까지 진행시키며, 플로우 상태를 자동으로 진행합니다.
예시: (1) 데이터 수집, (2) 보고서 생성, (3) 전달을 수행하는 주간 보고서 플로우. 태스크 플로우는 각 단계를 백그라운드 태스크로 생성하고, 완료를 기다린 후 다음 단계로 이동합니다.
플로우: weekly-report
단계 1: gather-data → 태스크 생성 → 성공
단계 2: generate-report → 태스크 생성 → 성공
단계 3: deliver → 태스크 생성 → 실행 중미러링 모드
태스크 플로우는 외부에서 생성된 태스크를 관찰하고, 태스크 생성의 소유권을 갖지 않으면서 플로우 상태를 동기화 상태로 유지합니다. 이는 크론 작업, CLI 명령 또는 다른 소스에서 태스크가 발생하고 이를 플로우로서 통합된 진행 상황을 보고 싶을 때 유용합니다.
예시: "오전 운영" 루틴을 함께 구성하는 세 개의 독립 크론 작업. 미러링된 플로우는 언제, 어떻게 실행되는지 제어하지 않으면서 전체 진행 상황을 추적합니다.
내구성 있는 상태 및 개정 추적
각 플로우는 자체 상태를 유지하고 개정을 추적하여 게이트웨이 재시작 후에도 진행 상황이 유지됩니다. 개정 추적을 통해 여러 소스가 동일한 플로우를 동시에 진행하려고 할 때 충돌을 감지할 수 있습니다.
취소 동작
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를 사용하십시오.