Фонові завдання

Фонові завдання відстежують роботу, яка виконується поза вашим основним сеансом розмови: запуски ACP, створення субагентів, ізольовані виконання завдань cron і операції, ініційовані CLI.

Завдання не замінюють сеанси, завдання cron або heartbeats - це журнал активності, який записує, яка відокремлена робота відбулася, коли саме та чи була вона успішною.

# Коротко

• Завдання - це записи, а не планувальники: cron і heartbeat вирішують, коли виконується робота, а завдання відстежують, що сталося.
• ACP, субагенти, усі завдання cron і операції CLI створюють завдання. Heartbeat-ходи не створюють.
• Кожне завдання проходить шлях queued → running → terminal (succeeded, failed, timed_out, cancelled або lost).
• Завдання cron залишаються активними, поки runtime cron усе ще володіє завданням; якщо стан runtime у пам'яті зник, обслуговування завдань спочатку перевіряє довговічну історію запусків cron, перш ніж позначати завдання як lost.
• Завершення керується push-механізмом: відокремлена робота може сповістити напряму або розбудити сеанс/Heartbeat запитувача після завершення, тому цикли опитування статусу зазвичай є неправильною формою.
• Ізольовані запуски cron і завершення субагентів за найкращою спробою очищають відстежувані вкладки браузера/процеси для свого дочірнього сеансу перед фінальним обліком очищення.
• Ізольована доставка cron приглушує застарілі проміжні відповіді батьківського сеансу, поки робота нащадкового субагента ще завершується, і надає перевагу фінальному виводу нащадка, якщо він надходить до доставки.
• Сповіщення про завершення доставляються безпосередньо в канал або ставляться в чергу для наступного Heartbeat.
• openclaw tasks list показує всі завдання; openclaw tasks audit виявляє проблеми.
• Термінальні записи зберігаються 7 днів, а потім автоматично видаляються.

# Швидкий старт

# List all tasks (newest first)
openclaw tasks list

# Filter by runtime or status
openclaw tasks list --runtime acp
openclaw tasks list --status running

# Show details for a specific task (by ID, run ID, or session key)
openclaw tasks show <lookup>

# Cancel a running task (kills the child session)
openclaw tasks cancel <lookup>

# Change notification policy for a task
openclaw tasks notify <lookup> state_changes

# Run a health audit
openclaw tasks audit

# Preview or apply maintenance
openclaw tasks maintenance
openclaw tasks maintenance --apply

# Inspect TaskFlow state
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

# Що створює завдання

# Життєвий цикл завдання

stateDiagram-v2
    [*] --> queued
    queued --> running : agent starts
    running --> succeeded : completes ok
    running --> failed : error
    running --> timed_out : timeout exceeded
    running --> cancelled : operator cancels
    queued --> lost : session gone > 5 min
    running --> lost : session gone > 5 min

Переходи відбуваються автоматично: коли пов'язаний запуск агента завершується, статус завдання оновлюється відповідно.

Завершення запуску агента є авторитетним для активних записів завдань. Успішний відокремлений запуск фіналізується як succeeded, звичайні помилки запуску фіналізуються як failed, а результати тайм-ауту або переривання фіналізуються як timed_out. Якщо оператор уже скасував завдання або runtime уже записав сильніший термінальний стан, як-от failed, timed_out або lost, пізніший сигнал успіху не знижує цей термінальний статус.

lost враховує runtime:

• Завдання ACP: зникли метадані базового дочірнього сеансу ACP.
• Завдання субагентів: базовий дочірній сеанс зник зі сховища цільового агента.
• Завдання cron: runtime cron більше не відстежує завдання як активне, а довговічна історія запусків cron не показує термінального результату для цього запуску. Офлайн-аудит CLI не вважає власний порожній стан runtime cron у процесі авторитетним.
• Завдання CLI: ізольовані завдання дочірнього сеансу використовують дочірній сеанс; завдання CLI на основі чату натомість використовують живий контекст запуску, тому завислі рядки сеансів каналу/групи/прямих повідомлень не підтримують їх активними. Запуски openclaw agent на основі Gateway також фіналізуються за результатом свого запуску, тому завершені запуски не залишаються активними, доки прибиральник не позначить їх як lost.

# Доставка та сповіщення

Коли завдання досягає термінального стану, OpenClaw сповіщає вас. Є два шляхи доставки:

Пряма доставка - якщо завдання має цільовий канал (requesterOrigin), повідомлення про завершення надходить прямо в цей канал (Telegram, Discord, Slack тощо). Для завершень субагентів OpenClaw також зберігає прив'язану маршрутизацію потоку/теми, коли вона доступна, і може заповнити відсутній to / обліковий запис зі збереженого маршруту сеансу запитувача (lastChannel / lastTo / lastAccountId), перш ніж відмовитися від прямої доставки.

Доставка через чергу сеансу - якщо пряма доставка не вдається або origin не задано, оновлення ставиться в чергу як системна подія в сеансі запитувача й з'являється під час наступного Heartbeat.

Це означає, що звичний робочий процес є push-орієнтованим: запустіть відокремлену роботу один раз, а потім дозвольте runtime розбудити вас або сповістити про завершення. Опитуйте стан завдання лише тоді, коли потрібне налагодження, втручання або явний аудит.

# Політики сповіщень

Керуйте тим, скільки повідомлень ви отримуєте про кожне завдання:

Змініть політику, поки завдання виконується:

openclaw tasks notify <lookup> state_changes

# Довідник CLI

openclaw tasks list [--runtime <acp|subagent|cron|cli>] [--status <status>] [--json]

openclaw tasks show <lookup>

openclaw tasks cancel <lookup>

openclaw tasks notify <lookup> <done_only|state_changes|silent>

openclaw tasks audit [--json]

openclaw tasks maintenance [--json]
openclaw tasks maintenance --apply [--json]

openclaw tasks flow list [--status <status>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>

# Дошка завдань чату (/tasks)

Використовуйте /tasks у будь-якому сеансі чату, щоб бачити фонові завдання, пов’язані з цим сеансом. Дошка показує активні та нещодавно завершені завдання з середовищем виконання, статусом, часом, а також деталями прогресу або помилки.

Коли поточний сеанс не має видимих пов’язаних завдань, /tasks переходить до локальних для агента лічильників завдань, тож ви все одно отримуєте огляд без розкриття деталей інших сеансів.

Для повного операторського реєстру використовуйте CLI: openclaw tasks list.

# Інтеграція статусу (навантаження завдань)

openclaw status містить короткий підсумок завдань:

Tasks: 3 queued · 2 running · 1 issues

Підсумок повідомляє:

• active - кількість queued + running
• failures - кількість failed + timed_out + lost
• byRuntime - розподіл за acp, subagent, cron, cli

І /status, і інструмент session_status використовують знімок завдань, що враховує очищення: активним завданням надається перевага, застарілі завершені рядки приховуються, а нещодавні помилки показуються лише тоді, коли не лишається активної роботи. Це зосереджує картку статусу на тому, що важливо саме зараз.

# Сховище й обслуговування

# Де зберігаються завдання

Записи завдань зберігаються в SQLite за адресою:

$OPENCLAW_STATE_DIR/tasks/runs.sqlite

Реєстр завантажується в пам’ять під час запуску Gateway і синхронізує записи в SQLite для довговічності між перезапусками. Gateway утримує журнал попереднього запису SQLite в обмежених межах, використовуючи стандартний поріг autocheckpoint SQLite, а також періодичні та завершальні контрольні точки TRUNCATE.

# Автоматичне обслуговування

Очищувач запускається кожні 60 секунд і виконує чотири речі:

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

# Пов’язане

• Автоматизація та завдання - усі механізми автоматизації стисло
• CLI: Завдання - довідник команд CLI
• Heartbeat - періодичні ходи основного сеансу
• Заплановані завдання - планування фонової роботи
• Task Flow - оркестрація flow над завданнями