用途
OpenClaw Bootstrap Debug 是一个调试技能,适用于沙箱已经存在、但 OpenClaw 的初始化(setup)、bundle 加载、网关(gateway)重启、插件发现(plugin discovery)或配置恢复(config restoration)出现故障的情况。
主要能力
该技能以“证据优先”(Evidence First)为原则,要求先收集以下信息,再判断问题所在:
GET /api/admin/sandbox-diag的端口探测结果。GET /api/admin/logs中按gateway.、sandbox.、bootstrap.、restore.过滤的日志。- 经过脱敏的
/home/vercel-sandbox/.openclaw/openclaw.json结构(shape)。 - 沙箱内的进程列表与端口。
/tmp/openclaw/openclaw-*.log的尾部内容,且需对密钥进行脱敏。- 从 wrapper 日志/配置中获取 bundle URL 与 sidecar 是否存在,而不是靠猜测。
常见故障分类
技能将常见问题拆分为以下几类,便于定位:
- Bootstrap 从未完成,还是快速恢复(fast restore)失败。
- Bundle 缺少 sidecar 资产,还是插件发现路径错误。
- 网关进程陈旧/僵死(stale/defunct),还是新进程无法绑定 3000 端口。
- 配置哈希发生变化,但动态恢复文件未包含相同字段。
- 频道目录(channel catalog)缺失,还是频道配置无效。
- Telegram 的 webhookSecret 在某条配置/哈希/恢复路径中缺失。
修复边界
技能指明了各类修复应触及的代码位置:
- 配置/重启:
src/server/openclaw/config.ts。 - Bootstrap/资产:
src/server/openclaw/{bootstrap,restore-assets}.ts。 - 生命周期调用方:
src/server/sandbox/lifecycle.ts。 - 频道配置同步:
src/server/channels/admin/apply-channel-config-change.ts。 - 测试:bootstrap/config/restore 测试,以及受影响的频道就绪(channel readiness)测试。
验证方式
- 运行
node scripts/verify.mjs --steps=test,typecheck。 - 运行
lat check。 - 对于实时修复,需包含网关启动前后的证据:进程列表、3000 端口探测、插件数量或路由注册情况,以及相关的
gateway.restart_*事件。
适用场景与限制
该技能适用于 vercel-openclaw 项目中沙箱已存在但 OpenClaw 启动、bundle、网关、插件或配置恢复环节出错的排查与修复。资料未提供该技能的安装命令、收费方式、支持平台或具体使用步骤,这些信息暂未提供。