cron-watchdog-debug

用途：用于处理 cron wake、看门狗、OpenClaw 定时任务与 restore-oracle 事件。核心要求是先取证再修复：提供部署状态证明、标注各边为 unknown/verified-good/verified-bad 的看门狗路径图、含最快证伪方式与状态的假设表，以及 Cron Watchdog Handoff。不可把“cron 路由执行了”当作 OpenClaw 定时任务已执行，需区分 Vercel Cron 调用、看门狗授权、持久化唤醒到期、沙箱唤醒、AI Gateway 令牌刷新、OpenClaw 调度器加载任务、用户可见投递等状态。取证：先建统一产物目录（RUN_TS、ART=.agent-runs/cron-debug/$RUN_TS，mkdir -p 其 admin/vercel/sandbox/workflow 子目录），在改代码前收集 project.json 与目标项目/团队/部署对比、git rev-parse HEAD 与 git ls-remote origin main、GET /api/status、/api/admin/sandbox-diag、按 watchdog./sandbox./gateway./cron/restore 过滤的 /api/admin/logs、以及 /api/cron/watchdog（需有效 cron 授权）。命令原样保留。看门狗路径图建议标注从 Vercel cron tick 到 /api/cron/watchdog 鉴权、runSandboxWatchdog、部署契约、元数据读取、busy/stale/running/stopped 分支、cron wake key 读取、ensureSandboxReady、令牌刷新、沙箱内 OpenClaw 任务、任务执行到投递可见的各边。运行时先读管理面，必要时用 npx sandbox 或 admin SSH/exec 做只读检查（进程、端口、/home/vercel-sandbox/.openclaw/cron 文件与任务结构），不打印可能含用户数据的任务载荷，优先记录形状、数量、id 与下次运行时间。存储侧关注 cronNextWakeMs、cronJobsJson、lastRestoreMetrics.cronRestoreOutcome、watchdog 报告中的 cron.wake/token.refresh/probe/restore.prepare 检查。修复边界限定在 watchdog 路由、watchdog run、watchdog 类型、sandbox lifecycle 及相关测试与文档；调试 cron 时勿改渠道路由。验证可选 verify.mjs、对应 node --test 与 lat check。限制：资料未提供部署平台、价格与效果信息，具体失败根因需按现场证据判定。