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 координує багатокрокові потоки поверх окремих завдань.
- Завдання автоматично відстежують усю відокремлену роботу, щоб ви могли її переглядати й аудіювати.
Пов'язане
- Заплановані завдання — точне планування та одноразові нагадування
- Виведені зобов'язання — подальші перевірки на зразок пам'яті
- Фонові завдання — реєстр завдань для всієї відокремленої роботи
- Task Flow — надійна оркестрація багатокрокових потоків
- Обробники — керовані подіями скрипти життєвого циклу
- Обробники Plugin — внутрішньопроцесні обробники інструментів, підказок, повідомлень і життєвого циклу
- Постійні накази — постійні інструкції агента
- Heartbeat — періодичні ходи основного сеансу
- Довідник конфігурації — усі ключі конфігурації