---
read_when:
    - Ви хочете зрозуміти, як потік завдань пов’язаний із фоновими завданнями
    - Ви натрапляєте на Task Flow або потік завдань openclaw у примітках до випуску чи документації
    - Ви хочете перевірити або керувати стійким станом потоку
summary: Рівень оркестрації потоків TaskFlow над фоновими завданнями
title: Потік завдань
x-i18n:
    generated_at: "2026-04-23T20:43:23Z"
    model: gpt-5.4
    provider: openai
    source_hash: 90286fb783db5417ab5e781377a85be76cd3f9e9b32da57558c2d8f02b813dba
    source_path: automation/taskflow.md
    workflow: 15
---

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

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

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

| Сценарій                              | Використання          |
| ------------------------------------- | --------------------- |
| Одне фонове завдання                  | Звичайне завдання     |
| Багатокроковий конвеєр (A, потім B, потім C) | TaskFlow (керований)  |
| Спостереження за зовнішньо створеними завданнями      | TaskFlow (дзеркальний) |
| Одноразове нагадування                | Завдання Cron         |

## Режими синхронізації

### Керований режим

TaskFlow повністю керує життєвим циклом. Він створює завдання як кроки потоку, доводить їх до завершення та автоматично переводить стан потоку далі.

Приклад: потік щотижневого звіту, який (1) збирає дані, (2) генерує звіт і (3) доставляє його. TaskFlow створює кожен крок як фонове завдання, очікує завершення, а потім переходить до наступного кроку.

```bash
Flow: weekly-report
  Step 1: gather-data     → task created → succeeded
  Step 2: generate-report → task created → succeeded
  Step 3: deliver         → task created → running
```

### Дзеркальний режим

TaskFlow спостерігає за зовнішньо створеними завданнями та підтримує стан потоку синхронізованим, не беручи на себе відповідальність за створення завдань. Це корисно, коли завдання походять із завдань Cron, команд CLI або інших джерел і ви хочете мати єдине уявлення про їхній прогрес як про потік.

Приклад: три незалежні завдання Cron, які разом утворюють процедуру «ранкових операцій». Дзеркальний потік відстежує їхній сукупний прогрес, не контролюючи, коли і як вони виконуються.

## Стійкий стан і відстеження ревізій

Кожен потік зберігає власний стан і відстежує ревізії, тож прогрес не втрачається після перезапусків Gateway. Відстеження ревізій дає змогу виявляти конфлікти, коли кілька джерел одночасно намагаються просунути той самий потік.

## Поведінка скасування

`openclaw tasks flow cancel` встановлює для потоку стійкий намір скасування. Активні завдання в межах потоку скасовуються, а нові кроки не запускаються. Намір скасування зберігається після перезапусків, тому скасований потік залишається скасованим, навіть якщо Gateway перезапускається до того, як усі дочірні завдання завершать роботу.

## Команди CLI

```bash
# Перелік активних і нещодавніх потоків
openclaw tasks flow list

# Показати відомості про певний потік
openclaw tasks flow show <lookup>

# Скасувати запущений потік і його активні завдання
openclaw tasks flow cancel <lookup>
```

| Команда                           | Опис                                              |
| --------------------------------- | ------------------------------------------------- |
| `openclaw tasks flow list`        | Показує відстежувані потоки зі статусом і режимом синхронізації |
| `openclaw tasks flow show <id>`   | Переглянути один потік за ідентифікатором потоку або ключем пошуку |
| `openclaw tasks flow cancel <id>` | Скасувати запущений потік і його активні завдання |

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

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

## Пов’язане

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