定时任务排障指南

技能简介

本技能汇总了Clawdbot/Moltbot定时任务（cron job）的常见故障模式与修复方案，涵盖工具死锁、消息丢失、时区错误和模型回退异常四类问题。

能做什么

• 诊断并修复cron工具调用超时问题
• 解决消息已发送但未送达的隐患
• 校正因时区缺失导致的执行时间偏差
• 防止备用模型违规调用工具

使用说明

无需安装，直接参考以下指令模板创建可靠的任务：

# 推荐写法：使用exec绕过死锁，显式指定时区和隔离会话
exec: clawdbot cron add \
  --name "daily-reminder" \
  --cron "0 9 * * 1-5" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "[INSTRUCTION: DO NOT USE ANY TOOLS] 你的提示词" \
  --deliver --channel telegram --to "CHAT_ID" \
  --best-effort-deliver

关键参数说明：

• --session isolated：创建独立会话，避免主会话消息堆积导致投递失败
• --tz：必须显式指定，否则默认UTC
• --best-effort-deliver：投递失败时不中断任务
• [INSTRUCTION: DO NOT USE ANY TOOLS]：嵌入消息正文，约束备用模型行为

输入与输出

见下方输入与输出表格。

风险提示

• 禁止直接调用cron工具，必须通过exec或bash代理执行
• 省略--session isolated可能导致消息在活跃对话中丢失
• 未指定--tz时，调度时间按UTC解析，易产生数小时偏差
• 备用模型可能无视系统指令，需将约束写入消息内容

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/promadgenius/ez-cronjob/SKILL.md
来源类型：GitHub仓库文档