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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Короткий довідник для вибору

Сценарій використанняРекомендованоЧому
Надіслати щоденний звіт рівно о 9:00Заплановані завдання (Cron)Точний час, ізольоване виконання
Нагадайте мені через 20 хвилинЗаплановані завдання (Cron)Одноразове завдання з точним часом (--at)
Запускати щотижневий глибокий аналізЗаплановані завдання (Cron)Окреме завдання, можна використати іншу модель
Перевіряти вхідні кожні 30 хвHeartbeatПакетується з іншими перевірками, враховує контекст
Моніторити календар на майбутні подіїHeartbeatПриродно підходить для періодичної обізнаності
Перевірити стан після згаданої співбесідиВиведені зобов’язанняПодальша дія на кшталт пам’яті, без точного запиту нагадування
Делікатна перевірка стану після контексту користувачаВиведені зобов’язанняОбмежено тим самим агентом і каналом
Перевірити стан підлеглого агента або запуску ACPФонові завданняЖурнал завдань відстежує всю відокремлену роботу
Перевірити, що запускалося і колиФонові завданняopenclaw tasks list і openclaw tasks audit
Багатоетапне дослідження з подальшим підсумкомTask FlowСтійка оркестрація з відстеженням ревізій
Запустити скрипт під час скидання сесіїОбробникиКерується подіями, спрацьовує на подіях життєвого циклу
Виконувати код на кожному виклику інструментаPlugin hooksВнутрішньопроцесні обробники можуть перехоплювати виклики інструментів
Завжди перевіряти відповідність перед відповіддюПостійні розпорядженняАвтоматично додаються в кожну сесію

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

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

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

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

Cron — вбудований планувальник Gateway для точного часу. Він зберігає роботи, пробуджує агента в потрібний момент і може доставляти результат у чат-канал або endpoint 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 hooks. Див. Обробники.

​
Heartbeat

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

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

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

​
Пов’язане