Запланированные задачи

​

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

openclaw cron create "2026-02-01T16:00:00Z" \
  --name "Reminder" \
  --session main \
  --system-event "Reminder: check the cron docs draft" \
  --wake now \
  --delete-after-run

openclaw cron list
openclaw cron get <job-id>
openclaw cron show <job-id>

openclaw cron runs --id <job-id>

​

Как работает Cron

• Cron выполняется внутри процесса Gateway (не внутри модели).
• Определения заданий, состояние выполнения и история запусков сохраняются в общей базе данных состояния SQLite OpenClaw, поэтому перезапуски не теряют расписания.
• При обновлении выполните openclaw doctor --fix, чтобы импортировать устаревшие файлы ~/.openclaw/cron/jobs.json, jobs-state.json и runs/*.jsonl в SQLite и переименовать их с суффиксом .migrated. Некорректные строки заданий пропускаются во время выполнения и копируются в jobs-quarantine.json для последующего исправления или проверки.
• cron.store по-прежнему задает логический ключ хранилища Cron и путь импорта doctor. После импорта редактирование этого JSON-файла больше не меняет активные задания Cron; вместо этого используйте openclaw cron add|edit|remove или RPC-методы Cron в Gateway.
• Все выполнения Cron создают записи фоновых задач.
• При запуске Gateway просроченные задания изолированных ходов агента перепланируются за пределы окна подключения каналов, а не воспроизводятся немедленно, поэтому запуск Discord/Telegram и настройка нативных команд остаются отзывчивыми после перезапусков.
• Одноразовые задания (--at) по умолчанию автоматически удаляются после успешного выполнения.
• Изолированные запуски Cron по возможности закрывают отслеживаемые вкладки браузера/процессы для своего сеанса cron:<jobId> после завершения запуска, чтобы отсоединенная браузерная автоматизация не оставляла осиротевшие процессы.
• Изолированные запуски Cron, получившие узкое разрешение на самоочистку Cron, все еще могут читать состояние планировщика, самоотфильтрованный список своего текущего задания и историю запусков этого задания, поэтому проверки статуса/Heartbeat могут просматривать собственное расписание без получения более широкого доступа на изменение Cron.
• Изолированные запуски Cron также защищаются от устаревших подтверждающих ответов. Если первый результат — это только промежуточное обновление статуса (on it, pulling everything together и похожие подсказки), а ни один дочерний субагентский запуск больше не отвечает за финальный ответ, OpenClaw один раз повторно запрашивает фактический результат перед доставкой.
• Изолированные запуски Cron используют структурированные метаданные отказа выполнения из встроенного запуска, включая обертки node-host UNAVAILABLE, у которых вложенное сообщение об ошибке начинается с SYSTEM_RUN_DENIED или INVALID_REQUEST, поэтому заблокированная команда не отображается как успешный запуск, а обычный текст ассистента не считается отказом.
• Изолированные запуски Cron также считают ошибки агента на уровне запуска ошибками задания, даже когда полезная нагрузка ответа не создана, поэтому ошибки модели/провайдера увеличивают счетчики ошибок и запускают уведомления о сбоях, а не очищают задание как успешное.
• Когда изолированное задание хода агента достигает timeoutSeconds, Cron прерывает базовый запуск агента и дает ему короткое окно очистки. Если запуск не завершается, очистка, принадлежащая Gateway, принудительно очищает владение сеансом этого запуска до того, как Cron запишет тайм-аут, поэтому поставленная в очередь работа чата не остается за устаревшим обрабатывающим сеансом.
• Если изолированный ход агента зависает до старта runner или до первого вызова модели, Cron записывает тайм-аут с указанием фазы, например setup timed out before runner start или stalled before first model call (last phase: context-engine). Эти watchdog-механизмы покрывают встроенных провайдеров и провайдеров на базе CLI до фактического запуска их внешнего CLI-процесса и ограничиваются независимо от длинных значений timeoutSeconds, чтобы сбои холодного старта/аутентификации/контекста проявлялись быстро, а не ждали полного бюджета задания.
• Если вы используете системный cron или другой внешний планировщик для запуска openclaw agent, оберните его эскалацией жесткого завершения, даже несмотря на то что CLI обрабатывает SIGTERM/SIGINT. Запуски через Gateway просят Gateway прервать принятые запуски; локальные и встроенные резервные запуски получают тот же сигнал прерывания. Для GNU timeout предпочитайте timeout -k 60 600 openclaw agent ... вместо простого timeout 600 ...; значение -k — это аварийный предел супервизора, если процесс не может корректно завершиться. Для systemd units сохраняйте ту же форму, используя сигнал остановки SIGTERM плюс окно ожидания, например TimeoutStopSec, перед финальным завершением. Если повторная попытка переиспользует --run-id, пока исходный запуск Gateway все еще активен, дубликат отображается как выполняющийся, а не запускает второй запуск.

​

Типы расписаний

​

День месяца и день недели используют логику OR

# Intended: "9 AM on the 15th, only if it's a Monday"
# Actual:   "9 AM on every 15th, AND 9 AM on every Monday"
0 9 15 * 1

​

Стили выполнения

​

Полезные нагрузки команд

openclaw cron create "*/15 * * * *" \
  --name "Queue depth probe" \
  --command "scripts/check-queue.sh" \
  --command-cwd "/srv/app" \
  --announce \
  --channel telegram \
  --to "-1001234567890"

​

Параметры payload для изолированных заданий

1. Переопределение модели Gmail hook (когда запуск пришел из Gmail и это переопределение разрешено)
2. model в payload отдельного задания
3. Выбранное пользователем сохраненное переопределение модели cron-сессии
4. Выбор модели агента/по умолчанию

​

Доставка и вывод

​

Язык вывода

openclaw cron edit <jobId> \
  --message "Суммируй обновления. Ответь на китайском; оставь URL, код и названия продуктов без изменений."

• cron.failureDestination задает глобальное значение по умолчанию для уведомлений о сбоях.
• job.delivery.failureDestination переопределяет его для отдельного задания.
• Если не задано ни одно из них, а задание уже доставляет сообщения через announce, уведомления о сбоях теперь используют этот основной целевой объект announce как резервный.
• delivery.failureDestination поддерживается только для заданий sessionTarget="isolated", если основной режим доставки не webhook.
• failureAlert.includeSkipped: true включает для задания или глобальной политики оповещений cron повторяющиеся оповещения о пропущенных запусках. Пропущенные запуски ведут отдельный счетчик последовательных пропусков, поэтому они не влияют на backoff при ошибках выполнения.

​

Примеры CLI

openclaw cron add \
  --name "Calendar check" \
  --at "20m" \
  --session main \
  --system-event "Next heartbeat: check calendar." \
  --wake now

openclaw cron create "0 7 * * *" \
  "Summarize overnight updates." \
  --name "Morning brief" \
  --tz "America/Los_Angeles" \
  --session isolated \
  --announce \
  --channel slack \
  --to "channel:C1234567890"

openclaw cron add \
  --name "Deep analysis" \
  --cron "0 6 * * 1" \
  --tz "America/Los_Angeles" \
  --session isolated \
  --message "Weekly deep analysis of project progress." \
  --model "opus" \
  --thinking high \
  --announce

openclaw cron create "0 18 * * 1-5" \
  "Summarize today's deploys as JSON." \
  --name "Deploy digest" \
  --webhook "https://example.invalid/openclaw/cron"

openclaw cron create "*/15 * * * *" \
  --name "Queue depth probe" \
  --command "scripts/check-queue.sh" \
  --command-cwd "/srv/app" \
  --announce \
  --channel telegram \
  --to "-1001234567890"

​

Webhooks

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
  },
}

​

Аутентификация

• Authorization: Bearer <token> (рекомендуется)
• x-openclaw-token: <token>

curl -X POST http://127.0.0.1:18789/hooks/wake \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"text":"New email received","mode":"now"}'

curl -X POST http://127.0.0.1:18789/hooks/agent \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"message":"Summarize inbox","name":"Email","model":"openai/gpt-5.4"}'

​

Интеграция Gmail PubSub

​

Настройка мастером (рекомендуется)

openclaw webhooks gmail setup --account openclaw@gmail.com

​

Автозапуск Gateway

​

Ручная одноразовая настройка

gcloud auth login
gcloud config set project <project-id>
gcloud services enable gmail.googleapis.com pubsub.googleapis.com

gcloud pubsub topics create gog-gmail-watch
gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
  --member=serviceAccount:gmail-api-push@system.gserviceaccount.com \
  --role=roles/pubsub.publisher

gog gmail watch start \
  --account openclaw@gmail.com \
  --label INBOX \
  --topic projects/<project-id>/topics/gog-gmail-watch

​

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

{
  hooks: {
    gmail: {
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}

​

Управление заданиями

# List all jobs
openclaw cron list

# Get one stored job as JSON
openclaw cron get <jobId>

# Show one job, including resolved delivery route
openclaw cron show <jobId>

# Edit a job
openclaw cron edit <jobId> --message "Updated prompt" --model "opus"

# Force run a job now
openclaw cron run <jobId>

# Force run a job now and wait for its terminal status
openclaw cron run <jobId> --wait --wait-timeout 10m --poll-interval 2s

# Run only if due
openclaw cron run <jobId> --due

# View run history
openclaw cron runs --id <jobId> --limit 50

# View one exact run
openclaw cron runs --id <jobId> --run-id <runId>

# Delete a job
openclaw cron remove <jobId>

# Agent selection (multi-agent setups)
openclaw cron create "0 6 * * *" "Check ops queue" --name "Ops sweep" --session isolated --agent ops
openclaw cron edit <jobId> --clear-agent

​

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

{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 8,
    retry: {
      maxAttempts: 3,
      backoffMs: [60000, 120000, 300000],
      retryOn: ["rate_limit", "overloaded", "network", "server_error"],
    },
    webhookToken: "replace-with-dedicated-webhook-token",
    sessionRetention: "24h",
    runLog: { maxBytes: "2mb", keepLines: 2000 },
  },
}

​

Устранение неполадок

​

Лестница команд

openclaw status
openclaw gateway status
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
openclaw doctor

​

Связанные материалы

• Автоматизация — все механизмы автоматизации в одном обзоре
• Фоновые задачи — журнал задач для выполнений cron
• Heartbeat — периодические ходы основного сеанса
• Часовой пояс — конфигурация часового пояса