结论先行：请暂时不要升级到 OpenClaw 3.22。该版本已确认存在两个严重问题，会导致控制台不可用和多款插件静默失效，生产环境用户建议立即回滚或等待后续补丁。

已知重大问题

Dashboard 打开即 503，日志报「Control UI assets not found」
原因：dist/control-ui/ 目录在发布到 npm 时被误排除，导致安装包缺失前端资源。

该目录在 git 仓库与 Docker 镜像中是完整的，但 npm tarball 中没有这些文件。已在 issue #52808 跟踪。

多个插件静默损坏（如 WhatsApp、ACPX 及另外 4 个）
原因：这些插件被加入 optionalBundledClusters，但发布流程未设置 OPENCLAW_INCLUDE_OPTIONAL_BUNDLED=1，从而被排除在 dist/extensions/ 之外。升级后会出现误导性警告，相关频道随即停止工作。
更棘手的是：ClawHub 上存在名为 whatsapp@0.0.5-Alpha 的损坏社区包，而 3.22 调整为优先从 ClawHub 解析插件，进一步放大了问题。

新增影响与注意事项

• 社区反馈：从 3.13 升至 3.22 后，系统丧失构建/部署能力，仅保留聊天功能。
• 原因排查：新版强化了沙箱模型，单纯关闭 sandbox 不足以恢复；此外配置文件在升级过程中可能被覆盖，原有能力被新的默认安全设置禁用。

当前建议

• 生产环境：暂缓升级至 3.22，等待官方补丁。已升级者建议回滚或改用源码编译。

快速回滚示例

npm i -g openclaw@2026.3.13
openclaw doctor --non-interactive
openclaw gateway restart

你不必会写代码：交给智能代理处理

如果你不熟悉排障流程，可借助 Claude Code / Codex 或其他智能代理来分析日志、生成配置并执行修复。

操作步骤

1. 打开终端，先抓取日志：

   openclaw logs --follow > /tmp/openclaw.log 2>&1

2. 启动 Claude Code（或同类工具），并告知：

   请分析 /tmp/openclaw.log，找出 OpenClaw 崩溃的原因并给出修复方案。

3. 让它为你生成配置（示例需求）：

   帮我为 OpenClaw 生成一套合理的 config.yaml：
   - 使用 Anthropic Claude Sonnet 作为模型
   - 开启执行前二次确认的安全模式（exec.ask: on）
   - 写入 ~/.openclaw/config.yaml

日常维护常用指令

• 健康检查（发现配置问题、服务异常）

  openclaw doctor

• 查看实时日志

  openclaw logs --follow

• 重启 Gateway

  openclaw gateway restart

• 升级到最新版

  npm install -g openclaw@latest

• 回滚到指定版本

  npm install -g openclaw@1.x.x

安全加固提示词（可直接交给 Claude Code 执行）

现在帮我完成 OpenClaw 的安全加固配置：
1. 读取当前 ~/.openclaw/config.yaml 的内容
2. 将 Gateway 绑定到本机回环地址（127.0.0.1），防止局域网其他设备访问
3. 开启执行操作前需要二次确认的安全模式
4. 把 API Key 从配置文件移出，改为从环境变量 ANTHROPIC_API_KEY 读取
5. 将修改后的配置写回文件
6. 重启 Gateway 使配置生效
7. 运行 openclaw doctor 做一次全面健康检查，并把结果输出给我

一键排障提示词

OpenClaw 刚才崩溃了，
请帮我抓取最新日志，分析崩溃原因，给出修复方案并执行。

新增技能（Skill）示例需求

想新增一个“文件整理” Skill：按文件类型将桌面文件分类到对应子文件夹。请按 OpenClaw Skill 规范实现，放入正确目录并重载配置。

最后提醒

当前 3.22 存在阻断性缺陷：控制台资源缺失、插件集成异常和能力收紧带来的回归风险。在官方发布修复补丁前，建议维持稳定版本或采用源码构建，并以以上流程进行诊断与加固。