---
read_when:
    - Task Flow와 백그라운드 작업의 관계를 이해하려는 경우
    - 릴리스 노트나 문서에서 Task Flow 또는 openclaw tasks flow를 접하게 됩니다
    - 영속적인 플로우 상태를 검사하거나 관리하려는 경우
summary: 백그라운드 태스크 위의 TaskFlow 흐름 오케스트레이션 계층
title: 작업 흐름
x-i18n:
    generated_at: "2026-05-10T19:21:17Z"
    model: gpt-5.5
    provider: openai
    source_hash: 135227b250840cd579f10a8ab4211e9319c447bb4d6df25907738ea138fc2d2a
    source_path: automation/taskflow.md
    workflow: 16
---

Task Flow는 [백그라운드 작업](/ko/automation/tasks) 위에 위치하는 플로 오케스트레이션 기반입니다. 개별 작업은 분리된 작업의 단위로 유지하면서, 자체 상태, 리비전 추적, 동기화 의미 체계를 가진 내구성 있는 다단계 플로를 관리합니다.

## Task Flow를 사용할 때

작업이 여러 순차 단계나 분기 단계에 걸쳐 있고 Gateway 재시작 후에도 내구성 있는 진행 상황 추적이 필요할 때 Task Flow를 사용하세요. 단일 백그라운드 작업에는 일반 [작업](/ko/automation/tasks)으로 충분합니다.

| 시나리오                              | 사용                  |
| ------------------------------------- | -------------------- |
| 단일 백그라운드 작업                 | 일반 작업           |
| 다단계 파이프라인(A 다음 B 다음 C) | Task Flow(관리됨)  |
| 외부에서 생성된 작업 관찰      | Task Flow(미러링됨) |
| 일회성 알림                     | Cron 작업             |

## 신뢰할 수 있는 예약 워크플로 패턴

시장 인텔리전스 브리핑과 같은 반복 워크플로의 경우, 일정, 오케스트레이션, 신뢰성 검사를 별도 계층으로 다루세요.

1. 타이밍에는 [예약 작업](/ko/automation/cron-jobs)을 사용하세요.
2. 워크플로가 이전 컨텍스트를 기반으로 구축되어야 한다면 영구 cron 세션을 사용하세요.
3. 결정적 단계, 승인 게이트, 재개 토큰에는 [Lobster](/ko/tools/lobster)를 사용하세요.
4. 자식 작업, 대기, 재시도, Gateway 재시작을 가로지르는 다단계 실행을 추적하려면 Task Flow를 사용하세요.

Cron 예시 형태:

```bash
openclaw cron add \
  --name "Market intelligence brief" \
  --cron "0 7 * * 1-5" \
  --tz "America/New_York" \
  --session session:market-intel \
  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \
  --announce \
  --channel slack \
  --to "channel:C1234567890"
```

반복 워크플로에 의도적인 이력, 이전 실행 요약, 또는 상시 컨텍스트가 필요할 때는 `isolated` 대신 `session:<id>`를 사용하세요. 각 실행이 새로 시작되어야 하고 필요한 모든 상태가 워크플로에 명시되어 있다면 `isolated`를 사용하세요.

워크플로 안에서는 LLM 요약 단계 전에 신뢰성 검사를 배치하세요.

```yaml
name: market-intel-brief
steps:
  - id: preflight
    command: market-intel check --json
  - id: collect
    command: market-intel collect --json
    stdin: $preflight.json
  - id: summarize
    command: market-intel summarize --json
    stdin: $collect.json
  - id: approve
    command: market-intel deliver --preview
    stdin: $summarize.json
    approval: required
  - id: deliver
    command: market-intel deliver --execute
    stdin: $summarize.json
    condition: $approve.approved
```

권장 사전 검사:

- 브라우저 가용성과 프로필 선택. 예를 들어 관리되는 상태에는 `openclaw`, 로그인된 Chrome 세션이 필요할 때는 `user`를 사용합니다. [브라우저](/ko/tools/browser)를 참고하세요.
- 각 소스의 API 자격 증명과 할당량.
- 필요한 엔드포인트에 대한 네트워크 도달 가능성.
- 에이전트에 필요한 도구 활성화 여부. 예: `lobster`, `browser`, `llm-task`.
- Cron의 실패 대상이 구성되어 있어 사전 검사 실패가 표시되는지 여부. [예약 작업](/ko/automation/cron-jobs#delivery-and-output)을 참고하세요.

수집된 모든 항목에 권장되는 데이터 출처 필드:

```json
{
  "sourceUrl": "https://example.com/report",
  "retrievedAt": "2026-04-24T12:00:00Z",
  "asOf": "2026-04-24",
  "title": "Example report",
  "content": "..."
}
```

요약 전에 워크플로가 오래된 항목을 거부하거나 오래됨으로 표시하게 하세요. LLM 단계에는 구조화된 JSON만 전달되어야 하며, 출력에서 `sourceUrl`, `retrievedAt`, `asOf`를 보존하도록 요청해야 합니다. 워크플로 안에서 스키마 검증 모델 단계가 필요할 때는 [LLM Task](/ko/tools/llm-task)를 사용하세요.

재사용 가능한 팀 또는 커뮤니티 워크플로의 경우 CLI, `.lobster` 파일, 모든 설정 참고 사항을 Skills 또는 Plugin으로 패키징하고 [ClawHub](/ko/clawhub)를 통해 게시하세요. Plugin API에 필요한 일반 기능이 없는 경우가 아니라면 워크플로별 가드레일은 해당 패키지 안에 유지하세요.

## 동기화 모드

### 관리 모드

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 명령, 또는 다른 소스에서 시작되고, 그 진행 상황을 하나의 플로로 통합해 보고 싶을 때 유용합니다.

예: 함께 "morning ops" 루틴을 구성하는 세 개의 독립적인 Cron 작업입니다. 미러링된 플로는 언제 또는 어떻게 실행되는지를 제어하지 않고 전체 진행 상황을 추적합니다.

## 내구성 있는 상태와 리비전 추적

각 플로는 자체 상태를 영구 저장하고 리비전을 추적하므로 Gateway 재시작 후에도 진행 상황이 유지됩니다. 리비전 추적은 여러 소스가 동일한 플로를 동시에 진행하려 할 때 충돌 감지를 가능하게 합니다.
플로 레지스트리는 주기적 체크포인트와 종료 체크포인트를 포함한 제한된 write-ahead-log 유지 관리를 갖춘 SQLite를 사용하므로, 장시간 실행되는 Gateway가 제한 없는 `registry.sqlite-wal` 사이드카 파일을 유지하지 않습니다.

## 취소 동작

`openclaw tasks flow cancel`은 플로에 고정 취소 의도를 설정합니다. 플로 안의 활성 작업은 취소되고 새 단계는 시작되지 않습니다. 취소 의도는 재시작 후에도 유지되므로, 모든 자식 작업이 종료되기 전에 Gateway가 재시작되더라도 취소된 플로는 취소된 상태로 남습니다.

## CLI 명령

```bash
# List active and recent flows
openclaw tasks flow list

# Show details for a specific flow
openclaw tasks flow show <lookup>

# Cancel a running flow and its active tasks
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`를 사용하세요.

## 관련 항목

- [백그라운드 작업](/ko/automation/tasks) — 플로가 조정하는 분리된 작업 원장
- [CLI: 작업](/ko/cli/tasks) — `openclaw tasks flow`에 대한 CLI 명령 참조
- [자동화 개요](/ko/automation) — 모든 자동화 메커니즘 한눈에 보기
- [Cron 작업](/ko/automation/cron-jobs) — 플로에 공급될 수 있는 예약 작업