Automation and tasks

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

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

Коли використовувати потік завдань

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

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

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

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

Використовуйте Scheduled Tasks для часу запуску.
Використовуйте постійну сесію Cron, коли робочий процес має спиратися на попередній контекст.
Використовуйте Lobster для детермінованих кроків, етапів схвалення та токенів відновлення.
Використовуйте потік завдань, щоб відстежувати багатокроковий запуск через дочірні завдання, очікування, повторні спроби та перезапуски Gateway.

Приклад форми Cron:

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:

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 для керованого стану або user, коли потрібна сесія Chrome з виконаним входом. Див. Browser.
Облікові дані API та квота для кожного джерела.
Доступність мережі для потрібних кінцевих точок.
Увімкнені для агента потрібні інструменти, такі як lobster, browser і llm-task.
Налаштоване місце призначення для збоїв Cron, щоб помилки перевірки перед запуском були видимими. Див. Scheduled Tasks.

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

{
  "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 не бракує потрібної загальної можливості.

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

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

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

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

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

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

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

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

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

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

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

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

Команди CLI

# 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, щоб переглядати потік-оркестратор.

Пов’язане

Background Tasks — реєстр відокремленої роботи, яку координують потоки
CLI: tasks — довідник команд CLI для openclaw tasks flow
Automation Overview — усі механізми автоматизації в одному огляді
Cron Jobs — заплановані завдання, які можуть передавати дані в потоки

# Коли використовувати потік завдань

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

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

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

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

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

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

# Команди CLI

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

# Пов’язане