Cron-задачи в OpenClaw: автоматизация по расписанию

Представьте: каждое утро в 7:00 ваш AI-агент просыпается, проверяет почту, анализирует новые задачи и отправляет вам краткий отчёт в Telegram. Или через 20 минут напоминает о звонке. Всё это — cron-задачи в OpenClaw.

Cron — встроенный планировщик Gateway. Он хранит задачи, будит агента в нужное время и доставляет результаты в выбранный канал. Это не модельная фича — cron работает на уровне сервера и переживает перезагрузки.

Быстрый старт

Одноразовое напоминание

openclaw cron add \
  --name "Напоминание" \
  --at "2026-02-17T16:00:00Z" \
  --session main \
  --system-event "Напоминание: проверить документацию" \
  --wake now \
  --delete-after-run

Повторяющаяся задача с доставкой

openclaw cron add \
  --name "Утренний брифинг" \
  --cron "0 7 * * *" \
  --tz "Europe/Moscow" \
  --session isolated \
  --message "Составь краткий обзор новостей и задач на сегодня." \
  --announce \
  --channel telegram \
  --to "-1001234567890"

Основные концепции

Три типа расписания

• at — одноразовое событие по ISO 8601 времени
• every — фиксированный интервал в миллисекундах
• cron — стандартное cron-выражение (5 полей) с опциональным часовым поясом IANA

Два стиля выполнения

Main session (системные события)

Задача помещает системное событие в основную сессию и будит heartbeat. Подходит для задач, которым нужен полный контекст основного разговора.

Isolated (изолированные задачи)

Задача запускает отдельный агентный ход в сессии cron:<jobId>. Каждый запуск — свежая сессия без предыдущего контекста. Идеально для фоновых задач, которые не должны засорять основной чат.

Доставка результатов

Изолированные задачи могут доставлять результаты тремя способами:

• announce (по умолчанию) — отправка результата в канал (Telegram, WhatsApp, Discord, Slack)
• webhook — POST запрос на указанный URL
• none — без доставки (только внутренне)

Примеры доставки в Telegram

Для обычного чата:

--channel telegram --to "-1001234567890"

Для форум-топика:

--channel telegram --to "-1001234567890:topic:123"

Переопределение модели

Для изолированных задач можно указать другую модель или уровень мышления:

{
  "payload": {
    "kind": "agentTurn",
    "message": "Проанализируй логи за ночь.",
    "model": "anthropic/claude-sonnet-4-5",
    "thinking": "medium"
  }
}

Хранение и история

• Задачи: ~/.openclaw/cron/jobs.json
• История запусков: ~/.openclaw/cron/runs/<jobId>.jsonl
• Одноразовые задачи удаляются после успешного выполнения

Конфигурация

{
  cron: {
    enabled: true,
    maxConcurrentRuns: 2,
  },
}

Отключить cron: cron.enabled: false или переменная окружения OPENCLAW_SKIP_CRON=1.

CLI-команды

• openclaw cron add — создать задачу
• openclaw cron list — список задач
• openclaw cron run <job-id> — запустить вручную
• openclaw cron runs --id <job-id> — история запусков
• openclaw cron edit <job-id> — редактировать
• openclaw cron remove <job-id> — удалить

Cron vs Heartbeat: когда что использовать

Используйте Cron когда:

• Нужно точное время выполнения
• Задача должна быть изолирована от основной сессии
• Хотите использовать другую модель
• Нужно одноразовое напоминание

Используйте Heartbeat когда:

• Несколько проверок можно объединить
• Нужен контекст из недавних сообщений
• Точное время не критично

Подробнее о настройке OpenClaw — в справочнике конфигурации. О возможностях OpenClaw — в нашем обзоре.