← Back to Skills Marketplace
shimonxin

Cron Delivery Fix

by Shimon Xin · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
61
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install cron-delivery-fix
Description
Diagnose and fix OpenClaw cron job delivery failures. Script-based approach to prevent manual config errors. Fixes silent delivery failures, missing delivery...
README (SKILL.md)

Cron Delivery Fix

Diagnose and fix OpenClaw cron job message delivery failures. Uses scripted operations to prevent manual configuration errors.

Trigger Conditions

  • User reports "didn't receive scheduled task message"
  • Cron status shows delivered but user didn't receive it
  • Cron status shows not-delivered
  • Need to batch-check/fix all cron delivery configs

Core Lessons (Historical Incident Log)

This issue recurred on multiple dates. Each manual fix introduced new problems:

  1. Session context: Isolated session cron jobs lack contextToken, causing silent message failures
  2. Missing params: Some tasks were missing to/channel/accountId, resulting in incomplete delivery
  3. Config wipe: Manual --no-deliver accidentally cleared delivery configs; wrong --session caused invalid combinations

Root cause: Manually running openclaw cron edit one by one easily misses parameters or creates illegal configs.

Solution: Use scripts for unified management. Never manually edit cron session/delivery fields.

Delivery Config Specification

Valid Config Combinations

sessionTarget payload.kind delivery.mode Description
isolated agentTurn announce AI executes + cron auto-delivers summary (requires complete to/channel/accountId)
isolated agentTurn none AI self-delivers via message tool (must include send params in prompt)
main systemEvent none Triggers in main session (no independent delivery)

Invalid Configurations

Combination Error Reason
main + agentTurn Gateway rejects: main cron jobs require payload.kind="systemEvent"
announce + missing to No delivery target, message cannot be sent
announce + missing accountId Multi-account setups deliver to wrong account
none + agent in isolated session AI's message tool lacks contextToken in isolated session

Standard Template for Delivery Tasks

All cron jobs that need to send messages to users must have:

sessionTarget: isolated
payload.kind: agentTurn
delivery.mode: announce
delivery.channel: \x3Cyour-channel-id>
delivery.to: \x3Cyour-user-id>
delivery.accountId: \x3Cyour-account-id>

Standard Template for Silent Tasks

Tasks that don't need to send messages:

sessionTarget: isolated
payload.kind: agentTurn
delivery.mode: none

Operation Flow

Step 1: Diagnose

bash skills/cron-delivery-fix/scripts/diagnose.sh

Outputs delivery status of all cron jobs, flagging problematic ones.

Step 2: Fix

# Fix a single job
bash skills/cron-delivery-fix/scripts/fix-single.sh \x3Cjob-id> [--announce|--silent]

# Fix all delivery-type jobs
bash skills/cron-delivery-fix/scripts/fix-all.sh

# Restore a broken job (with valid config)
bash skills/cron-delivery-fix/scripts/restore.sh \x3Cjob-id>

Step 3: Verify

# Run diagnosis again to confirm no issues
bash skills/cron-delivery-fix/scripts/diagnose.sh

# Manual trigger test
openclaw cron run \x3Cjob-id>

Prohibited Operations

  1. Never manually use openclaw cron edit --session main on agentTurn-type tasks
  2. Never use --no-deliver to clear delivery config then re-add params one by one (easy to miss params)
  3. Never modify cron config without validating the combination is legal
  4. Never fix cron without running diagnose.sh to verify afterwards
Usage Guidance
Review carefully before installing. Only use this in an environment where you are prepared for the skill to modify OpenClaw cron jobs, and do not run the fix scripts until the destination channel, recipient, and account values are replaced with your intended values and you have exported or backed up existing cron configuration.
Capability Assessment
⚠ Purpose & Capability
The stated purpose of diagnosing and fixing OpenClaw cron delivery is coherent, but the implementation goes beyond diagnosis by bulk-editing cron jobs, forcing fixed delivery channel/recipient/account values, and potentially changing delivery behavior for unrelated jobs.
⚠ Instruction Scope
The skill instructs users to run fix-all and restore scripts, but it does not require a dry run, per-job selection, confirmation, rollback, or explicit user-supplied delivery destinations before persistent cron edits.
⚠ Install Mechanism
The package includes executable shell scripts and OpenClaw CLI mutation commands, while the skill metadata does not declare corresponding shell or cron-modification authority for user review.
⚠ Credentials
Access to scheduled-job delivery configuration is high impact because it can redirect or suppress automated messages; the hard-coded global settings are not proportionate for a generic delivery-fix tool.
⚠ Persistence & Privilege
The scripts make persistent cron configuration changes and provide verification, but no backup, transaction, or rollback path before applying bulk edits.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cron-delivery-fix
  3. After installation, invoke the skill by name or use /cron-delivery-fix
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Full English translation of SKILL.md and all content
v1.0.0
首个公开版本：OpenClaw cron投递诊断与修复，自动检测静默失败并修复prompt
Metadata
Slug cron-delivery-fix
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Cron Delivery Fix?

Diagnose and fix OpenClaw cron job delivery failures. Script-based approach to prevent manual config errors. Fixes silent delivery failures, missing delivery... It is an AI Agent Skill for Claude Code / OpenClaw, with 61 downloads so far.

How do I install Cron Delivery Fix?

Run "/install cron-delivery-fix" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Cron Delivery Fix free?

Yes, Cron Delivery Fix is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Cron Delivery Fix support?

Cron Delivery Fix is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Cron Delivery Fix?

It is built and maintained by Shimon Xin (@shimonxin); the current version is v1.0.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463368 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259467 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200457 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191163 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190189 · by oswalpalash

💬 Comments