cron

openclaw cron

Administra trabajos de cron para el programador del Gateway.

Relacionado:

• Trabajos cron: Trabajos cron

Sugerencia: ejecuta openclaw cron --help para ver la superficie completa de comandos.

Nota: los trabajos aislados cron add tienen por defecto el envío --announce. Usa --no-deliver para mantener la salida interna. --deliver permanece como un alias obsoleto para --announce.

Nota: los trabajos de una sola vez (--at) se eliminan después del éxito de forma predeterminada. Usa --keep-after-run para mantenerlos.

Nota: para trabajos de CLI de una sola vez, las fechas y horas --at sin desfase se tratan como UTC a menos que también pases --tz <iana>, lo que interpreta esa hora local del reloj de pared en la zona horaria dada.

Nota: los trabajos recurrentes ahora utilizan un retroceso de reintentos exponencial después de errores consecutivos (30s → 1m → 5m → 15m → 60m) y luego vuelven a la programación normal después de la próxima ejecución exitosa.

Nota: openclaw cron run ahora regresa tan pronto como se pone en cola la ejecución manual. Las respuestas exitosas incluyen { ok: true, enqueued: true, runId }; usa openclaw cron runs --id <job-id> para seguir el resultado final.

Nota: la retención/poda se controla en la configuración:

• cron.sessionRetention (por defecto 24h) poda las sesiones de ejecución aisladas completadas.
• cron.runLog.maxBytes + cron.runLog.keepLines podan ~/.openclaw/cron/runs/<jobId>.jsonl.

Nota de actualización: si tiene trabajos cron más antiguos de antes del formato actual de entrega/almacenamiento, ejecute openclaw doctor --fix. Doctor ahora normaliza los campos cron heredados (jobId, schedule.cron, campos de entrega de nivel superior, incluidos los campos threadId heredados y los alias de entrega provider del payload) y migra los trabajos de reserva notify: true de webhook simples a una entrega de webhook explícita cuando cron.webhook está configurado.

Ediciones comunes

Actualizar la configuración de entrega sin cambiar el mensaje:

openclaw cron edit <job-id> --announce --channel telegram --to "123456789"

Desactivar la entrega para un trabajo aislado:

openclaw cron edit <job-id> --no-deliver

Activar el contexto de arranque ligero para un trabajo aislado:

openclaw cron edit <job-id> --light-context

Anunciar a un canal específico:

openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"

Crear un trabajo aislado con contexto de arranque ligero:

openclaw cron add \
  --name "Lightweight morning brief" \
  --cron "0 7 * * *" \
  --session isolated \
  --message "Summarize overnight updates." \
  --light-context \
  --no-deliver

--light-context se aplica solo a trabajos de turno de agente aislados. Para las ejecuciones cron, el modo ligero mantiene el contexto de arranque vacío en lugar de inyectar el conjunto completo de arranque del espacio de trabajo.