---
read_when:
    - Ви хочете зрозуміти, як Task Flow пов’язаний із фоновими завданнями
    - Ви натрапили на Task Flow або openclaw tasks flow у примітках до випуску чи документації
    - Ви хочете перевірити або керувати стійким станом потоку
summary: Рівень оркестрації потоків Task Flow над фоновими завданнями
title: Task Flow
x-i18n:
    generated_at: "2026-04-05T17:56:51Z"
    model: gpt-5.4
    provider: openai
    source_hash: 172871206b839845db807d9c627015890f7733b862e276853d5dbfbe29e03883
    source_path: automation/taskflow.md
    workflow: 15
---

# Task Flow

Task Flow — це базовий рівень оркестрації потоків, розташований над [фоновими завданнями](/automation/tasks). Він керує стійкими багатокроковими потоками з власним станом, відстеженням ревізій і семантикою синхронізації, тоді як окремі завдання залишаються одиницею відокремленої роботи.

## Коли використовувати Task Flow

Використовуйте Task Flow, коли робота охоплює кілька послідовних або розгалужених кроків і вам потрібно стійке відстеження поступу між перезапусками шлюзу. Для окремих фонових операцій достатньо звичайного [завдання](/automation/tasks).

| Сценарій                              | Використання          |
| ------------------------------------- | --------------------- |
| Окреме фонове завдання                | Звичайне завдання     |
| Багатокроковий конвеєр (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

```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>`   | Переглянути один потік за ідентифікатором потоку або ключем пошуку |
| `openclaw tasks flow cancel <id>` | Скасувати активний потік і його активні завдання    |

## Як потоки пов’язані із завданнями

Потоки координують завдання, а не замінюють їх. Один потік може керувати кількома фоновими завданнями протягом свого життєвого циклу. Використовуйте `openclaw tasks`, щоб переглядати окремі записи завдань, і `openclaw tasks flow`, щоб переглядати потік оркестрації.

## Пов’язане

- [Фонові завдання](/automation/tasks) — реєстр відокремленої роботи, яку координують потоки
- [CLI: tasks](/cli/index#tasks) — довідник команд CLI для `openclaw tasks flow`
- [Огляд автоматизації](/automation) — усі механізми автоматизації з першого погляду
- [Завдання cron](/automation/cron-jobs) — заплановані завдання, які можуть надходити до потоків
