Перейти до основного вмісту

Automation & Tasks

OpenClaw виконує роботу у фоновому режимі за допомогою tasks, запланованих завдань, event hooks і постійних інструкцій. Ця сторінка допоможе вам вибрати правильний механізм і зрозуміти, як вони поєднуються між собою.

Короткий посібник з вибору

Випадок використанняРекомендованоЧому
Надсилати щоденний звіт рівно о 9:00Scheduled Tasks (Cron)Точний час, ізольоване виконання
Нагадай мені через 20 хвилинScheduled Tasks (Cron)Одноразове завдання з точним часом (--at)
Запускати щотижневий глибокий аналізScheduled Tasks (Cron)Автономне завдання, може використовувати іншу модель
Перевіряти вхідні кожні 30 хвилинHeartbeatОб’єднує перевірки з іншими, враховує контекст
Відстежувати календар на майбутні подіїHeartbeatПриродно підходить для періодичної обізнаності
Перевірити статус субагента або запуску ACPBackground TasksЖурнал tasks відстежує всю відокремлену роботу
Перевірити, що запускалося і колиBackground Tasksopenclaw tasks list і openclaw tasks audit
Багатокрокове дослідження, а потім підсумокTask FlowСтійка оркестрація з відстеженням ревізій
Запустити скрипт під час скидання сесіїHooksКерується подіями, спрацьовує на подіях життєвого циклу
Виконувати код під час кожного виклику інструментаHooksHooks можуть фільтрувати за типом події
Завжди перевіряти відповідність перед відповіддюStanding OrdersАвтоматично вставляються в кожну сесію

Scheduled Tasks (Cron) проти Heartbeat

ВимірScheduled Tasks (Cron)Heartbeat
ЧасТочний (cron-вирази, одноразово)Приблизний (типово кожні 30 хв)
Контекст сесіїНовий (ізольований) або спільнийПовний контекст основної сесії
Записи tasksСтворюються завждиНіколи не створюються
ДоставкаКанал, webhook або без виводуВбудовано в основну сесію
Найкраще дляЗвітів, нагадувань, фонових завданьПеревірки вхідних, календаря, сповіщень
Використовуйте Scheduled Tasks (Cron), коли вам потрібен точний час або ізольоване виконання. Використовуйте Heartbeat, коли робота виграє від повного контексту сесії, а приблизний час є прийнятним.

Основні поняття

Заплановані завдання (cron)

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

Tasks

Журнал фонових tasks відстежує всю відокремлену роботу: запуски ACP, породження субагентів, ізольовані виконання cron і операції CLI. Tasks — це записи, а не планувальники. Використовуйте openclaw tasks list і openclaw tasks audit, щоб їх переглядати. Див. Background Tasks.

Task Flow

Task Flow — це підкладка оркестрації flow поверх фонових tasks. Вона керує стійкими багатокроковими flow з керованими й дзеркальними режимами синхронізації, відстеженням ревізій і openclaw tasks flow list|show|cancel для перевірки. Див. Task Flow.

Standing orders

Standing orders надають агенту постійні операційні повноваження для визначених програм. Вони зберігаються у файлах робочого простору (зазвичай AGENTS.md) і вставляються в кожну сесію. Поєднуйте з cron для контролю, прив’язаного до часу. Див. Standing Orders.

Hooks

Hooks — це скрипти, керовані подіями, які запускаються подіями життєвого циклу агента (/new, /reset, /stop), ущільненням сесії, запуском gateway, потоком повідомлень і викликами інструментів. Hooks автоматично виявляються з каталогів і ними можна керувати за допомогою openclaw hooks. Див. Hooks.

Heartbeat

Heartbeat — це періодичний хід основної сесії (типово кожні 30 хвилин). Він об’єднує кілька перевірок (вхідні, календар, сповіщення) в один хід агента з повним контекстом сесії. Ходи heartbeat не створюють записів tasks. Використовуйте HEARTBEAT.md для невеликого контрольного списку або блок tasks:, якщо вам потрібні лише періодичні перевірки за строком виконання в межах самого heartbeat. Порожні файли heartbeat пропускаються як empty-heartbeat-file; режим лише прострочених tasks пропускається як no-tasks-due. Див. Heartbeat.

Як вони працюють разом

  • Cron обробляє точні розклади (щоденні звіти, щотижневі огляди) і одноразові нагадування. Усі виконання cron створюють записи tasks.
  • Heartbeat обробляє рутинний моніторинг (вхідні, календар, сповіщення) одним об’єднаним ходом кожні 30 хвилин.
  • Hooks реагують на конкретні події (виклики інструментів, скидання сесії, ущільнення) за допомогою власних скриптів.
  • Standing orders надають агенту постійний контекст і межі повноважень.
  • Task Flow координує багатокрокові flow поверх окремих tasks.
  • Tasks автоматично відстежують усю відокремлену роботу, щоб ви могли її переглядати й аудіювати.

Пов’язане

  • Scheduled Tasks — точне планування й одноразові нагадування
  • Background Tasks — журнал tasks для всієї відокремленої роботи
  • Task Flow — стійка оркестрація багатокрокових flow
  • Hooks — скрипти життєвого циклу, керовані подіями
  • Standing Orders — постійні інструкції агента
  • Heartbeat — періодичні ходи основної сесії
  • Configuration Reference — усі ключі конфігурації