Task Flow — це субстрат оркестрації потоків, що розташований над фоновими завданнями. Він керує довговічними багатокроковими потоками з власним станом, відстеженням ревізій і семантикою синхронізації, тоді як окремі завдання залишаються одиницею відокремленої роботи.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Коли використовувати Task Flow
Використовуйте Task Flow, коли робота охоплює кілька послідовних або розгалужених кроків і вам потрібне довговічне відстеження прогресу після перезапусків Gateway. Для одиночних фонових операцій достатньо звичайного завдання.| Сценарій | Використання |
|---|---|
| Одиночна фонова робота | Звичайне завдання |
| Багатокроковий конвеєр (A, потім B, потім C) | Task Flow (керований) |
| Спостереження за зовнішньо створеними завданнями | Task Flow (дзеркальний) |
| Одноразове нагадування | Завдання Cron |
Надійний шаблон запланованого робочого процесу
Для повторюваних робочих процесів, як-от зведень ринкової аналітики, розглядайте розклад, оркестрацію та перевірки надійності як окремі шари:- Використовуйте заплановані завдання для часу запуску.
- Використовуйте сталу сесію cron, коли робочий процес має спиратися на попередній контекст.
- Використовуйте Lobster для детермінованих кроків, шлюзів затвердження та токенів відновлення.
- Використовуйте Task Flow для відстеження багатокрокового запуску через дочірні завдання, очікування, повторні спроби та перезапуски Gateway.
session:<id> замість isolated, коли повторюваний робочий процес потребує навмисної історії, підсумків попередніх запусків або сталого контексту. Використовуйте isolated, коли кожен запуск має починатися з чистого стану, а весь потрібний стан явно заданий у робочому процесі.
Усередині робочого процесу розміщуйте перевірки надійності перед кроком підсумку LLM:
- Доступність браузера та вибір профілю, наприклад
openclawдля керованого стану абоuser, коли потрібна сесія Chrome із виконаним входом. Див. Browser. - Облікові дані API та квота для кожного джерела.
- Мережева доступність потрібних кінцевих точок.
- Потрібні інструменти, увімкнені для агента, як-от
lobster,browserіllm-task. - Призначення для збоїв налаштоване для cron, щоб помилки попередніх перевірок були видимі. Див. заплановані завдання.
sourceUrl, retrievedAt і asOf у вихідних даних. Використовуйте LLM Task, коли потрібен крок моделі з перевіркою схеми всередині робочого процесу.
Для багаторазово використовуваних командних або спільнотних робочих процесів запакуйте CLI, файли .lobster і будь-які нотатки з налаштування як skill або plugin і опублікуйте через ClawHub. Тримайте специфічні для робочого процесу запобіжники в цьому пакеті, якщо в API plugin не бракує потрібної загальної можливості.
Режими синхронізації
Керований режим
Task Flow повністю володіє життєвим циклом. Він створює завдання як кроки потоку, доводить їх до завершення та автоматично просуває стан потоку. Приклад: потік щотижневого звіту, який (1) збирає дані, (2) генерує звіт і (3) доставляє його. Task Flow створює кожен крок як фонове завдання, чекає завершення, а потім переходить до наступного кроку.Дзеркальний режим
Task Flow спостерігає за зовнішньо створеними завданнями та підтримує стан потоку синхронізованим, не перебираючи на себе створення завдань. Це корисно, коли завдання походять із cron jobs, команд CLI або інших джерел, і ви хочете мати уніфікований огляд їхнього прогресу як потоку. Приклад: три незалежні cron jobs, які разом утворюють ранкову операційну процедуру. Дзеркальний потік відстежує їхній сукупний прогрес, не контролюючи, коли або як вони виконуються.Довговічний стан і відстеження ревізій
Кожен потік зберігає власний стан і відстежує ревізії, щоб прогрес переживав перезапуски Gateway. Відстеження ревізій забезпечує виявлення конфліктів, коли кілька джерел одночасно намагаються просунути той самий потік. Реєстр потоків використовує SQLite з обмеженим обслуговуванням журналу випереджувального запису, зокрема періодичними контрольними точками та контрольними точками під час завершення роботи, щоб довготривалі Gateway не зберігали необмежені допоміжні файлиregistry.sqlite-wal.
Поведінка скасування
openclaw tasks flow cancel встановлює для потоку стійкий намір скасування. Активні завдання всередині потоку скасовуються, і нові кроки не запускаються. Намір скасування зберігається після перезапусків, тому скасований потік залишається скасованим, навіть якщо Gateway перезапуститься до завершення всіх дочірніх завдань.
Команди CLI
| Команда | Опис |
|---|---|
openclaw tasks flow list | Показує відстежувані потоки зі статусом і режимом синхронізації |
openclaw tasks flow show <id> | Переглянути один потік за ідентифікатором потоку або ключем пошуку |
openclaw tasks flow cancel <id> | Скасувати запущений потік і його активні завдання |
Як потоки пов’язані із завданнями
Потоки координують завдання, а не замінюють їх. Один потік може керувати кількома фоновими завданнями протягом свого життєвого циклу. Використовуйтеopenclaw tasks, щоб переглядати записи окремих завдань, і openclaw tasks flow, щоб переглядати оркеструвальний потік.
Пов’язане
- Фонові завдання — журнал відокремленої роботи, яку координують потоки
- CLI: tasks — довідник команд CLI для
openclaw tasks flow - Огляд автоматизації — усі механізми автоматизації одним поглядом
- Cron Jobs — заплановані завдання, які можуть подаватися в потоки