SuperAPI AI 工具集

openclaw-bootstrap-debug

部署与运维

查看项目

更新于 10-16 06:10

技能介绍

用途

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、网关、插件或配置恢复环节出错的排查与修复。资料未提供该技能的安装命令、收费方式、支持平台或具体使用步骤,这些信息暂未提供。