Clawdbot 定时任务排障专家

来自 Clawdbot 生产调试经验的 cron 故障排除指南，帮助用户解决定时任务消息投递失败、时区错误、工具超时等常见问题，确保自动化任务可靠运行。

基本信息

• 技能名称?ez-cronjob
• 中文名称?Clawdbot 定时任务排障专家
• 作者?ProMadGenius
• 分类?开发
• 版本?v1.0.0
• 标签?troubleshooting, automation, devops, telegram, operations, productivity

使用方法

使用说明
核心用法
ez-cronjob 是一个纯文档型的故障排除技能，专门针对 Clawdbot/Moltbot 平台的 cron 定时任务系统。它不提供可执行代码，而是作为上下文知识库注入到 AI 助手的对话中，当用户遇到定时任务相关问题时，AI 能够引用其中的专业指导进行诊断和修复。
该技能覆盖了五大核心问题场景：内部 cron 工具死锁导致的超时、消息投递失败、时区配置错误、降级模型不遵循指令，以及任务卡死在错误状态。每个问题都提供了症状识别、根因分析和具体解决方案，并配有可直接使用的 CLI 命令示例。
显著优点
实战经验丰富 ：内容源自作者 Isaac Zarzuri 在生产环境中的真实调试经历，非理论文档，每一条建议都经过验证。
即查即用 ：采用问题-症状-解决方案的结构化格式，用户可快速定位问题并获取修复命令，无需通读全文。
安全零风险 ：纯 Markdown 文档，无可执行代码、无网络请求、无权限需求，从根本上杜绝了恶意代码执行的可能性。
配置模板完备 ：提供了"黄金法则"配置模板和多个完整工作示例（每日站会提醒、一次性提醒、周报等），用户可复制修改后直接使用。
潜在缺点与局限性
平台绑定性强 ：技能内容高度专属于 Clawdbot/Moltbot 生态系统，对使用其他定时任务系统（如 Linux crontab、AWS EventBridge、GitHub Actions 等）的用户几乎没有参考价值。
时效性依赖 ：Clawdbot/Moltbot 平台若更新 CLI 接口或行为，文档中的命令示例可能过时。目前版本为 1.0.0，需关注后续维护。
被动式辅助 ：作为文档型技能，它无法主动监控用户的 cron 任务状态或自动修复问题，仍需用户手动执行建议的命令。
作者维护规模有限 ：项目为个人开发者维护（T2 来源可信度），非大型社区项目，长期更新保障相对较弱。
适合的目标群体
Clawdbot/Moltbot 活跃用户 ：需要配置 Telegram/WhatsApp 定时消息推送的开发者或运营人员
自动化运维人员 ：负责维护基于 Clawdbot 的自动化工作流，需要确保任务高可靠交付
AI Agent 开发者 ：构建基于 Clawdbot 平台的自动化代理，需要规避常见的定时任务陷阱
跨时区团队协作 ：使用时区功能协调全球团队日程的用户
使用风险
操作风险 ：文档中的调试命令（如 clawdbot cron rm ）具有实际破坏性，误操作可能导致定时任务被删除。建议执行前确认 job-id。
配置依赖风险 ：若用户未严格遵循"黄金法则"中的 --session isolated 、 、 --tz` 等关键参数，仍可能遇到消息丢失或时区错误。
平台可用性风险 ：Clawdbot/Moltbot 网关服务若不可用，技能建议的修复命令（如 clawdbot gateway restart ）也无法执行。
模型行为不确定性 ：即使嵌入 [INSTRUCTION: DO NOT USE ANY TOOLS]] 提示，降级模型的行为仍可能存在一定不可预测性。