Automation and tasks

Автоматизація та завдання

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

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

flowchart TD
    START([What do you need?]) --> Q1{Schedule work?}
    START --> Q2{Track detached work?}
    START --> Q3{Orchestrate multi-step flows?}
    START --> Q4{React to lifecycle events?}
    START --> Q5{Give the agent persistent instructions?}
    START --> Q6{Remember a natural follow-up?}

    Q1 -->|Yes| Q1a{Exact timing or flexible?}
    Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
    Q1a -->|Flexible| HEARTBEAT[Heartbeat]

    Q2 -->|Yes| TASKS[Background Tasks]
    Q3 -->|Yes| FLOW[Task Flow]
    Q4 -->|Yes| HOOKS[Hooks]
    Q5 -->|Yes| SO[Standing Orders]
    Q6 -->|Yes| COMMITMENTS[Inferred Commitments]
Варіант використання Рекомендовано Чому
Надсилати щоденний звіт рівно о 9:00 Заплановані завдання (Cron) Точний час, ізольоване виконання
Нагадати мені через 20 хвилин Заплановані завдання (Cron) Одноразове виконання з точним часом (--at)
Запускати щотижневий глибокий аналіз Заплановані завдання (Cron) Автономне завдання, може використовувати іншу модель
Перевіряти вхідні кожні 30 хв Heartbeat Об'єднується з іншими перевірками, враховує контекст
Відстежувати календар на наявність майбутніх подій Heartbeat Природно підходить для періодичної обізнаності
Перевірити стан після згаданої співбесіди Виведені зобов'язання Подальша дія на зразок пам'яті, без запиту точного нагадування
Ненав'язлива турботлива перевірка після контексту користувача Виведені зобов'язання Обмежено тим самим агентом і каналом
Перевірити стан підлеглого агента або запуску ACP Фонові завдання Реєстр завдань відстежує всю відокремлену роботу
Перевірити, що і коли виконувалося Фонові завдання openclaw tasks list і openclaw tasks audit
Багатокрокове дослідження з подальшим підсумком Task Flow Надійна оркестрація з відстеженням редакцій
Запустити скрипт під час скидання сеансу Обробники Керовані подіями, спрацьовують на події життєвого циклу
Виконувати код під час кожного виклику інструмента Обробники Plugin Внутрішньопроцесні обробники можуть перехоплювати виклики інструментів
Завжди перевіряти відповідність перед відповіддю Постійні накази Автоматично додаються до кожного сеансу

Заплановані завдання (Cron) проти Heartbeat

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

Використовуйте заплановані завдання (Cron), коли потрібен точний час або ізольоване виконання. Використовуйте Heartbeat, коли робота виграє від повного контексту сеансу, а приблизний час підходить.

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

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

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

Див. Заплановані завдання.

Завдання

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

Див. Фонові завдання.

Виведені зобов'язання

Зобов'язання — це короткочасні спогади про подальші дії, які потрібно явно увімкнути. OpenClaw виводить їх зі звичайних розмов, обмежує тим самим агентом і каналом та доставляє належні перевірки через Heartbeat. Точні нагадування, запитані користувачем, усе ще належать до cron.

Див. Виведені зобов'язання.

Task Flow

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

Див. Task Flow.

Постійні накази

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

Див. Постійні накази.

Обробники

Внутрішні обробники — це керовані подіями скрипти, які запускаються подіями життєвого циклу агента (/new, /reset, /stop), Compaction сеансу, запуском Gateway і потоком повідомлень. Вони автоматично виявляються з каталогів, і ними можна керувати за допомогою openclaw hooks. Для внутрішньопроцесного перехоплення викликів інструментів використовуйте обробники Plugin.

Див. Обробники.

Heartbeat

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

Див. Heartbeat.

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

  • Cron обробляє точні розклади (щоденні звіти, щотижневі огляди) та одноразові нагадування. Усі виконання cron створюють записи завдань.
  • Heartbeat обробляє регулярний моніторинг (вхідні, календар, сповіщення) в одному об'єднаному ході кожні 30 хвилин.
  • Обробники реагують на конкретні події (скидання сеансу, Compaction, потік повідомлень) за допомогою власних скриптів. Обробники Plugin охоплюють виклики інструментів.
  • Постійні накази надають агенту постійний контекст і межі повноважень.
  • Task Flow координує багатокрокові потоки поверх окремих завдань.
  • Завдання автоматично відстежують усю відокремлену роботу, щоб ви могли її переглядати й аудіювати.

Пов'язане