用途
该技能用于 vercel-openclaw 的启动验证(launch verification)与远程冒烟调试(remote smoke debugging),主要面向 /api/admin/launch-verify、pnpm smoke:remote 以及 vclaw create 的就绪(readiness)失败场景。
主要能力
- 证据收集(Evidence First):收集请求模式(destructive 或 read-only,JSON 或 NDJSON)、脱敏后的完整阶段载荷(phase payload)、可用的 GET /api/admin/preflight 与持久化的 GET /api/admin/launch-verify、用于检查通道就绪的 GET /api/channels/summary,以及按 launch.、preflight.、sandbox.、gateway.、channels. 过滤的 GET /api/admin/logs。
- 阶段拆分(Phase Splits):分别报告每个阶段,包括 preflight、queuePing、ensureRunning、chatCompletions、wakeFromSleep、restorePrepared、channelReadiness。技能明确要求不要把 ready:false 归并为单一根因。failingChannelIds 是机器可读的通道失败列表;warningChannelIds 已弃用。
- 修复边界(Fix Boundaries):preflight 对应 src/server/deploy-preflight.ts、src/app/api/admin/preflight/route.ts;launch verify 对应 src/app/api/admin/launch-verify/route.ts、src/app/api/queues/launch-verify/route.ts;smoke 对应 src/server/smoke/remote-smoke.ts、src/server/smoke/remote-phases.ts;restore 阶段对应 src/server/sandbox/restore-oracle.ts 及其生命周期调用方。
使用方式
先按上述清单收集证据,逐阶段拆分报告结果,并依据修复边界定位代码位置。验证命令包括:
node scripts/verify.mjs --steps=test,typecheck
pnpm smoke:remote --base-url <url> [--destructive] [--auth-cookie "session=..."]
lat check
对于线上启动修复,需附上终端中的启动验证载荷以及修复前后确切的失败阶段。
适用场景
适用于排查 vercel-openclaw 的启动验证失败、远程冒烟测试问题,以及 vclaw create 就绪失败。
限制
除上述命令、路径与阶段名称外,具体运行环境、依赖版本、价格与支持平台等信息暂未提供。