← 返回 Skills 市场

Cron Delivery Fix

Name: Cron Delivery Fix
Author: shimonxin

作者 Shimon Xin · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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:

Session context: Isolated session cron jobs lack contextToken, causing silent message failures
Missing params: Some tasks were missing to/channel/accountId, resulting in incomplete delivery
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

Never manually use openclaw cron edit --session main on agentTurn-type tasks
Never use --no-deliver to clear delivery config then re-add params one by one (easy to miss params)
Never modify cron config without validating the combination is legal
Never fix cron without running diagnose.sh to verify afterwards

安全使用建议

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.

能力评估

⚠ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install cron-delivery-fix
安装完成后，直接呼叫该 Skill 的名称或使用 /cron-delivery-fix 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

Full English translation of SKILL.md and all content

v1.0.0

首个公开版本：OpenClaw cron投递诊断与修复，自动检测静默失败并修复prompt

元数据

Slug cron-delivery-fix

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题