На этой странице
На этой странице
Get started
`openclaw tasks`
Проверяйте долговременные фоновые задачи и состояние Task Flow. Если подкоманда не указана,
openclaw tasks эквивалентна openclaw tasks list.
Описание жизненного цикла и модели доставки см. в разделе Фоновые задачи,
а полные описания обнаруживаемых проблем — в его разделе tasks audit.
Использование
Корневые параметры
| Флаг | Описание |
|---|---|
--json |
Выводить данные в формате JSON. |
--runtime <name> |
Фильтровать по типу: subagent, acp, cron или cli. |
--status <name> |
Фильтровать по состоянию: queued, running, succeeded, failed, timed_out, cancelled или lost. |
Подкоманды
list
Выводит отслеживаемые фоновые задачи, начиная с самых новых.
show
Показывает одну задачу по идентификатору задачи, идентификатору запуска или ключу сеанса.
notify
Изменяет политику уведомлений для выполняющейся задачи.
cancel
Отменяет выполняющуюся фоновую задачу.
audit
Выявляет устаревшие, потерянные, не доставленные или иным образом несогласованные записи
задач и Task Flow. Потерянные задачи, сохраняемые до cleanupAfter, считаются предупреждениями;
потерянные задачи с истёкшим сроком или без временной отметки считаются ошибками.
--code принимает коды задач (stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps) и коды Task
Flow (restore_failed, stale_waiting, stale_blocked,
cancel_stuck, missing_linked_tasks, blocked_task_missing). Сведения
о степени серьёзности и условиях срабатывания для каждого кода см. в разделе
Фоновые задачи.
maintenance
Предварительно показывает или применяет согласование задач и Task Flow, проставление отметок очистки, удаление устаревших данных и очистку реестра сеансов устаревших запусков Cron.
Для задач Cron при согласовании используются сохранённые журналы запусков и состояние заданий,
прежде чем старая активная задача будет помечена как lost, поэтому завершённые запуски Cron
не становятся ложными ошибками аудита только из-за отсутствия состояния среды выполнения Gateway
в памяти. Автономный аудит через CLI не является достоверным источником данных о локальном для процесса Gateway
наборе активных заданий Cron. Задачи CLI с идентификатором запуска или идентификатором источника помечаются как
lost, когда их активный контекст запуска Gateway исчезает, даже если старая запись дочернего сеанса
сохраняется.
При применении обслуживание также удаляет строки реестра сеансов cron:<jobId>:run:<uuid>
старше 7 дней, сохраняя выполняющиеся в данный момент задания Cron
и не изменяя строки сеансов, не относящиеся к Cron.
flow
Проверяет или отменяет долговременное состояние Task Flow в журнале задач.
flow list --status принимает queued, running, waiting, blocked,
succeeded, failed, cancelled или lost.
