Automation

Потік завдань

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

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

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

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

Надійний шаблон запланованого робочого процесу

Для повторюваних робочих процесів, як-от зведень ринкової аналітики, розглядайте розклад, оркестрацію та перевірки надійності як окремі шари:

Використовуйте заплановані завдання для часу запуску.
Використовуйте сталу сесію cron, коли робочий процес має спиратися на попередній контекст.
Використовуйте Lobster для детермінованих кроків, шлюзів затвердження та токенів відновлення.
Використовуйте Task Flow для відстеження багатокрокового запуску через дочірні завдання, очікування, повторні спроби та перезапуски Gateway.

Приклад форми 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"

Використовуйте session:<id> замість isolated, коли повторюваний робочий процес потребує навмисної історії, підсумків попередніх запусків або сталого контексту. Використовуйте isolated, коли кожен запуск має починатися з чистого стану, а весь потрібний стан явно заданий у робочому процесі.

Усередині робочого процесу розміщуйте перевірки надійності перед кроком підсумку LLM:

yaml

name: market-intel-briefsteps:  - 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 для керованого стану або user, коли потрібна сесія Chrome із виконаним входом. Див. Browser.
Облікові дані API та квота для кожного джерела.
Мережева доступність потрібних кінцевих точок.
Потрібні інструменти, увімкнені для агента, як-от lobster, browser і llm-task.
Призначення для збоїв налаштоване для cron, щоб помилки попередніх перевірок були видимі. Див. заплановані завдання.

Рекомендовані поля походження даних для кожного зібраного елемента:

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, коли потрібен крок моделі з перевіркою схеми всередині робочого процесу.

Для багаторазово використовуваних командних або спільнотних робочих процесів запакуйте CLI, файли .lobster і будь-які нотатки з налаштування як skill або plugin і опублікуйте через ClawHub. Тримайте специфічні для робочого процесу запобіжники в цьому пакеті, якщо в API plugin не бракує потрібної загальної можливості.

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

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

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

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

Code

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 jobs, команд CLI або інших джерел, і ви хочете мати уніфікований огляд їхнього прогресу як потоку.

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

Довговічний стан і відстеження ревізій

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

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

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

Команди CLI

bash

# List active and recent flowsopenclaw tasks flow list # Show details for a specific flowopenclaw tasks flow show <lookup> # Cancel a running flow and its active tasksopenclaw tasks flow cancel <lookup>

Команда	Опис
`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 — заплановані завдання, які можуть подаватися в потоки

Was this useful?